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The  ARPANET  ...  Is  an  operational,  computerized,  packet 
switching  DoO  digital  network  which  provides  a capability  for 
terminals  or  geographically  separated  computers,  called  hosts, 
to  communicate  with  each  other. 


■ nSG  MESSAGE  HANDLING  PROGRAM  ...  for  reading,  sending,  and 
manipulating  network  mall  and  files  which  have  a "message  file 
format" . 


MAILSTAT  PROGRAM  ...  lists  and  permits  manipulation  of 
undeliverable  network  messages.  ^ 
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* TIP  USER'S  GUIDE  ...  describes  the  use  of  a terminal  connected 
to  a Terminal  Interface  Processor  (TIP)  In  the  ARPA  Network. 


* TENEX  ...  Is  a time-sharing  operating  system  built  around  the 
DEC  POP- 10  computer. 


• TOPS-20  ...  Is  a time-sharing  operating  system  based  on  the 
TENEX  operating  system  with  some  features  from  the  TOPS-10 
operating  system  and  a few  entirely  new  features  that  make  It 
possible  to  timeshare  the  OECSYSTEM-20  computer. 


* SNDMSG  ...  Is  a program  to  send  messages  to  users  throughout 
the  ARPANET. 


• INTRODUCTION  TO  HERMES  ...  a computer  program  for  sending  and 
receiving  messages  over  a computer  network,  and  creating  and 
managing  files  of  network  messages. 


SECUWITy.  CLASSiriCATlOW  OF  THIS  PACE  (Wh»n  Dtlm  Efllcr*. 


READ  INSTRUCTIONS 


REPORT  DOCUMENTATION  PAGE 


BEFORE  COMPLETING  FORM 


1.  RECIPIENT'S  CATALOG  NUMSEA 


|2.  GOVT  ACCESSION  NO, 


The  Joy  of  TENEX  and  TOPS-ZBlr  Part  One  * 


Technica 


• CONTRACT  O 


T.  AuThORIaJ 


<0.  PROGRAM  ELEMENT,  PROJECT,  TASK 


s perporminc  organization  name  and  address 


use/ Informat  ion  Sciences  Institute 
A676  Admiralty  Way 
Marina  del  Rey,  CA  90291 


II  CONTROLLING  OFFICE  NAME  AND  ADDRESS 


Defense  Advanced  Research  Projects  Agency  1 y/ 
1400  Wi  Ison  Blvd. 

Arlington,  VA  22209 

monitoring  agency  name  S ADDRESSri/ <«/r*r«nl  from  Cenlnttlng  Olllet) 


MareH  »79 


IS.  security  class,  (el  thie  repeH) 

Unclassi f ied 


ISa.  OECLASSIFICATION'DOWNCRAOINO 
SCHEDULE 


This  document  approved  for 


17.  OlSTfllSuTION  STATEMENT  (ot  «b«rr«cr  In  Block  30,  II  dllloront 


IS  supplementary  notes 


If.  KEY  WORDS  fConilnw#  on  roooroo  oldo  II  nocoooocf  m%d  Idonlltr  ky  block  mmbot) 


ARPANET,  Hermes,  MAILSTAT,  MSG,  SNOMSG,  TENEX,  TOPS-20 


^■STRACT  rConllnua  an  raaaraa  UPe  it  naeaaaaajr  amt  IPanlltr  Sf  Meek  wiker) 

This  is  a basic  manual  discussing  the  operation  of  the  ARPANET,  the 
TENEX  and  TOPS-20  operating  systems,  and  the  following  mail  handling 
programs;  SNDMSG,  MSG,  Hermes,  and  MAILSTAT.  ^ 


JuEt:  - if-  ^ 

I By_ 


ARPA  Order  No.  222S 
l$l/TM-79>15 

Jinnarjr  IfTf 


the  JOY  of  TENEX  and  TOPS-20  in  two  paru 


PART  ONE 


This  document  Is  one  of  a series  of  user  manuals 
being  made  available  by  ARPA  IPTO  through  ISI. 


Prepared  by  Chloe  Sommers  Holg 
USC/Informatlon  Sciences  Institute 


Iht*  research  is  tuiipotled  by  the  Advarreed  Research  IVojects  Age«Ky  under  Corrhacl  No.  OAHC  15  72  C 0308, 
ARPA  Order  No.  2223. 

Views  and  conclusiorts  contained  in  this  manual  are  the  euthor's. 

This  document  asatoved  lor  puMic  release  and  sale;  distribution  is  unlimiled. 


CONTENTS 


1.  A PROSE  GLOSSARY  1 

2.  The  ARPANET  10 

S.  TIP  USER’S  CHIDE  II 

5.1  INTRODUCTION  II 

3.2  THE  TIP  COMMAND  FORMAT  II 

3.3  TYPICAL  USE  OF  THE  TIP  IS 

3.4  ESTARLISHINC  PARAMETERS  IS 

3.5  CONNECI'ION  TO  REMOTE  SITES  14 

3.6  USE  OF  REMOTE  SITES  16 

3.7  CONNECTION  LOSS  AND  RESTORATION  17 

3.8  TIP  NEWS  AND  USER  FEEDBACK  18 

3.8  UNUSUAL  USES  OF  THE  TIP  19 

3.10  THE  DIVERT  OUTPUT  COMMAND  19 

3.11  EDITING  19 

3.12  THE  RESET  DEVICE  COMMAND  20 

3.13  COMMAND  SUMMARY  20 

3.14  niRLIOCRAPHY  25 

3.15  TERMINALS  USED  WITH  THE  TIP  26 

3.16  NEW  TELNET  PROTOCOL  IMPLEMENTATION  27 

3.16.1  Crllini;  In  and  Out  of  NEW  TELNET  Mode  27 

3.16.2  Echoing  28 

3.16.3  Binary  Input  and  Output  Options  28 

.3.16.4  Log  or  Open  a Connection  29 

3.16.5  Commands  Available  Under  NEW  TELNET  29 

4.  TENEX  SI 

4.1  OPERATING  SYSTEM  SI 

4.2  EX ECutlvr  LANGUAGE  S2 

4.2.1  Special  C:haraclers  SS 

4.3  EILESYSI'EM  S5 

4.3.1  Group  File  Access  S7 

4.4  EX  ECutIve  COMMANDS  S7 

4.4.1  Command  Fields  S7 

4.4.2  Command  Input  and  Recognition  S8 

4.4.3  Command  Terminators  ■ ••••••t******«M»««**S»**««M*«*«*»*«M»*««V**»>  S9 

4.4.4  Basic  Commands  S9 

4.5  FILE  ARCHIVAL/R^TRIEVAL  SYSTEM  46 

4.5.1  The  ARCHIVE  Command  *«••••••■••••••••••••••••«•••••••••*••••■•■•••••••••*•••*•*••**************************  46 

4.5.2  The  INTERROGATE  Command  48 


I 


Command  Summary 


TOPS.20 


OPERATING  SYSTEM  52 

COMMAND  LANGUAGE  5* 

5.2.1  Special  Characters  5^ 

FILESYSTEM  5^ 

5.5.1  Croup  File  Access  5® 

SYSTEM  COMMANDS  5® 

5.4.1  Typing  Commands  

5.4.2  Basic  Commands  

FILE  ARCIIIVAL/RETRIEVAL  SYSTEM  ^2 

5.5.1  THE  ARCHIVE  COMMAND  2S 

5.5.2  THE  INTERROGATE  COMMAND  24 

Basic  TENEX/TOPS-20  Command  Unguage  Differences  27 


SNDMSC  

5.1  THE  ADDRESSES  28 

6.1.1  Editing  and  Viewing  Control  Characters  29 

G.1.2  Inserting  a File  ®® 

8.2  THE  SUBJECT  FIELD  

6.5  THE  MESSAGE  FIELD  - 

6.5.1  Inserting  Pre-composed  Text  and  Editing  81 

6.4  SENDING  THE  MESSAGE  82 


MSG  MESSAGE  HANDLING  PROGRAM  85 

7.1  MSG  COMMANDS  87 

7.1.1  Commands  To  See  And  Move  Messages  87 

7.1.2  Commands  To  Update  Your  Message  Flies  88 

7.1.5  Commands  To  Read  Other  Message  Files  89 

7.1.4  Commands  To  Sequence  Through  The  Messages  89 

7.1.5  Other  Commands  8* 

7.1.6  Command  To  Run  Other  Programs  88 

7.1.7  Command  Summary  85 

7.2  RECEIVING  NEW  MESSAGES  WHILE  USING  MSG  97 

7.5  ERRORS  WHILE  READING  A MESSAGE  FILE  87 


INTRODUCTION  TO  HERMES 

8.1  PANIC  BUTTONS  

8.2  EDITING  CHARACTERS 

8.5  TYPING  COMMANDS  ».... 

8.4  ENTERING  HERMES  


8.5  LEAVING  HERMES  ... 

8.6  READING  MESSAGES 

8.7  SENDING  MESSAGES 

8.8  NAMED  SEQUENCES 


167 


B S 


W 

ik  ; j 


8.9  MKSSAGi:  MANAGEMENT  

8.10  MESSAGE  DELETING  

8.11  ON  LINE  DOCUMENTATION  

8.12  HERMES  BASIC  COMMAND  SUMMARY 


9.  MAILSTAT  PROGRAM  

9.1  USING  MAILSTAT  IN  HERMES 


1.  A PROSE  GLOSSARY 


Glossaries  of  technical  terms  are  my  often  of  little  nse  to  the  noeice  since  their  alphabetic 
order  does  not  reflect  any  other  logical  structure.  Attempted  here  is  a glossary  arranged  In 
a more  or  less  logical  fashion  with  an  index  [appended]  to  help  the  nonserial  user  find  a 
particular  term.  If  the  definition  does  not  shed  sufficient  light,  the  context  may. 

1 A computer  Is  a nachine  for  perfornino  complex  processes  on 

2 Information  without  manual  Intervention.  Analog  computers 

3 perform  this  function  by  directly  measuring  continuous  physical 

4 quantities  such  as  electrical  voltages.  The  best^known  enalog 

5 computer  Is  a slide  rule.  Digital  comptiters  represent  numer> 

6 leal  quantities  by  discrete  electrical  states  tdilch  can  be  manl- 

7 pulated  logically  and  hence  arithmetically.  Digital  computers 

8 are  sometimes  refered  to  as  electronic  data  processing  mack- 

9 ines,  EDP,  or  processors.  In  order  to  distinguish  the  actual 

10  physical  equipment  from  the  programs  which  extend  Its  useful- 

11  ness,  the  former  Is  called  hardware. 

12  The  central  processing  unit  (CPU)  or  main  frame  Is  the  portion 

13  of  the  computer  which  performs  the  calculations  and  decisions; 

14  the  memory  or  storage  Is  the  part  In  which  the  data  and  pro- 
13  grams  are  stored.  The  corrmemory  Is  the  main  meamry  of 

ID  most  modern  awchlnes;  It  Is  normally  the  only  memory 

17  directly  accessible  to  the  CPU.  Its  name  derives  from  Its 

18  composition;  small  ferrite  rings  called  cores.  The  computer 

19  stay  have  additional  memory  devices;  Information  Is  transferred 

20  between  these  and  the  core  memory.  The  most  usual  such 

21  memories  are  magnetic  drums  (spinning  cylinders  with  a 

22  magnetizable  recording  surface)  and  magnetic  discs  (flat 

23  spinning  discs  with  magnetizable  surfaces). 

24  The  capability  of  memory  devices  Is  measured  In  capacity  and 

25  speed  of  access.  The  storage  capacity  of  a memory  Is  measured 

28  In  words  (else  called  celts  or  registers)  which  are  usually  of 

27  fixed  length,  consisting  of  12  to  48  Mrs.  This  number  Is  called 
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28  tht  Mchlna's  mmrd length.  A bit  (binary  digit)  Is  the  Mlnlmun 

20  unit  of  Inforawtlon  storage  and  has  only  ttra  possible  values. 

30  Capacity  can  also  be  aieasured  In  bytes,  units  of  6 or  8 bits,  each 

32  Access  speed  of  a nenrary  Is  the  tlue  It  takes  for  the  processor 

33  to  obtain  a word  frow  Memory.  Core  memory  Is  called  random 

34  access  when  any  word  can  be  obtelned  at  any  time  without  regard 

35  to  Its  serial  order.  Drum,  tape,  and  disc  memories  are  serial 

36  access,  beceuse  the  words  pass  one  at  a time  as  they  move  past 

37  the  stetlon  where  they  may  be  accessed.  Speed  Is  usually 

38  spoken  In  terms  of  milliseconds  (msec)  (thousandths  of  a 

39  second),  microseconds  (usee)  (millionths  of  a second),  or  nano- 

40  seconds  (nsec)  (billionths  of  a second).  One  nanosecond  Is  the 

41  time  required  for  light  to  travel  almost  one  foot. 

r 

42  The  central  processor  and  the  memory  constitute  the  computer 

43  per  se;  to  get  deta  and  programs  Into  the  aiachlne  and  the  results 

44  out  are  the  role  of  the  Inpviloutpvs  equipment  or  HO. 

45  Input  devices  convert  Information  to  a form  which  It  can  be 

46  stored  In  the  computer's  memory.  The  commonest  form  of  Input 

47  Is  the  punched  card  or  Hollerith  card  (after  Its  Inventor).  Input 

48  devices  which  accept  cards  arc  called  card  readers  and  the  function 

49  they  perform  Is  commonly  called  reading,  as  Is  that  of  all  Input 

50  devices.  Cards  have  80  columns  with  12  possible  punch  positions; 

51  normally,  each  column  Is  used  to  represent  one  cheracter.  A set 

52  of  cards  Is  called  a deck.  Another  form  of  Input  Is  punched  paper 

53  tape  — continuous  tape  approximately  1 Inch  wide,  with  holes 

54  punched  across  Its  width  to  reprasent  characters  or  numeric 

55  quantities.  Magnetic  ink  character  readtrs  have  come  to  be 

56  used  for  Input,  particularly  In  banking:  they  can  Interpret 

57  characters  printed  with  e special  Ink.  Horn  recently,  optical 

58  scanners  have  appeared,  which  can  read  clearly  printed  or  typed 

59  material  of  given  type  fonts. 

60  Output  deaUes  usually  Include  a card  punch  (which  converts  the 

61  characters  stored  In  memory  to  punched  holes  In  a cord),  a tape 

62  puruh  (tdilch  performs  the  same  function  for  punched  paper  tape), 

63  and  a line  printer  (which  prints  numerals,  letters,  and  other 

64  characters  of  conventional  design  on  continuous  rolls  of  paper). 

65  When  it  passes  Information  to  these  devices,  the  computer  Is 

66  mriilng.  Recent  additions  to  the  output  family  Include  the  display 

67  device  which  exhibits  readable  characters  or  graphic  Information 

68  on  the  faco  of  a cathode  ray  tube  or  CRT . Theso  Images  must 

69  bo  road  at  once,  of  course,  since  they  ore  not  permanent. 
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InfoTMtlon  whfcti  can  ba  takan  away  In  pernanenk  forw  (such  as 
tha  output  of  a llna  printer)  Is  called  harda>pj.  A plotter  Is  an 
output  devica  which,  under  couputer  control,  can  draw  contin- 
uous lines  or  curves  on  paper,  thus  producing  graphs.  Maps, 
etc..  In  hard  copy.  Magnetic  tape  Is  widely  used  both  as  a foro 
of  MOMory  and  I/O.  It  can  be  stored  conveniently  away  froM  the 
Machine  and  can  be  read  or  written  by  the  coMputer  If  It  Is  put 
on  a tape  drive  attachad  to  the  cooputer.  It  Is  the  fastest  type  of 
I/O  and  tha  slowest  type  of  MOMory  except  when  used  for  serial 
reading. 


I/O  devices  connected  directly  to  the  computer  mamory  and  under 
control  of  the  CPU  are  spoken  of  as  being  on-line.  They  are  placed 
off-line  when  they  are  used  to  perforM  Independent  functions.  For 
exemple.  It  Is  common  to  exchange  Information  between  punched 
cards  and  magnetic  tape  off-line.  Some  devices  are  always  off- 
line. They  are  peripheral  equipment  and  ara  genarally  called 
collectively  electromechanical  accounting  machines  or  EAM . 

These  are  frequently  used  Independently  of  the  computer  and  In 
fact  antedate  computers  by  many  years.  The  most  common  are 
the  keypunch,  used  to  punch  cards,  the  reproducer,  which  makes 
copies  of  decks  of  cards,  and  the  sorter,  which  places  cards  In 
different  bins  as  a function  of  which  holes  ore  punched.  In  soma 
recent  systems,  another  on-line  I/O  device  hes  been  added,  the 
console  or  terminal.  These  are  Intended  for  the  user  to  Interact 
with  tha  machine,  and  usually  consist  of  a typewriterlike 
keyboard,  and  either  a typewriterlike  printing  mechanism  or 
another  display  devica  for  output. 


Information  Is  storvd  In  the  computer's  memory  In  the  form  of  the 
presence  or  absence  of  a magnetic  charge.  A collection  of  such 
*yes  or  no*  physical  states  Is  usually  thought  of  as  a binary 
number  (a  number  whose  only  possible  digits  are  0 and  1). 
Depending  on  context,  such  numbers  can  have  many  meanings; 

In  this  sense,  the  numbers  are  coded.  They  can  be  Intorprotod 
as  numeric  quantities,  characters  (letters,  digits,  punctuation 
marks)  or  instructions  or  commands  which  will  direct  the  com- 
puter to  perform  its  basic  functions  (add,  compare,  read,  ate.). 


A set  of  Instructions  to  perform  a specified  function  or  soivo  • 
complete  problem  Is  called  a program.  The  computer  performs 
such  Instructions  sequentially.  However,  as  the  cooputer  cen 
modify  the  data  In  Its  memory.  It  can  also  modify  Us  progrem. 
This  capability  to  modify  Its  own  directions  Is  a case  of  the 
engineering  principle  called  fosMack,  the  modification  of  future 
performance  on  the  basis  of  past  performance.  It  Is  because 
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113  of  this  distinctive  feature  that  Modern  digital  coMputers  are 

114  sometiMes  celled  stored  program  emputtrs . Parts  of  programs 

115  are  soMetiMes  called  routines  or  subroutines.  Subroutines 

116  which  perform  generally  useful  functions  are  sometimes  combined 

117  Into  a subroutine  library,  usually  on  magnetic  tape.  Copies  of 

118  relevant  subroutines  will  be  added  to  a program  automatically 

119  and  hence  need  not  be  developed  by  hand.  Single  Instructions  In 

120  a program  are  sometimes  called  steps.  When  a sequence  of 

121  program  steps  Is  operated  repeatedly,  the  process  Is  called  a 

122  loop.  Certain  Instructions  compare  two  quantities  and  select 

123  either  of  two  program  paths  on  the  basis  of  the  result:  these  are 

124  called  Ranching  instructions . 

125  The  data  on  which  a program  acts  are  usually  structured  Into 

126  tables.  Individual  values  which  control  the  operation  of  programs 

127  or  subroutines  are  parameters.  An  organized  collection  of  Infor- 

128  motion  In  the  computer  or  on  tape  Is  called  a file,  like  the 

129  organized  set  of  papers  In  a file  cabinet.  A database  or  data 

130  bank  Is  a large  and  complex  set  of  tables  which  describes  some 

131  aspect  of  the  world  outside  of  the  computer  (a  library  catalog, 

132  a student  record  file,  a budget). 

133  A programmer  Is  a person  who  converts  a problem  Into  a set 

134  of  directions  to  a computer  to  solve  It.  The  function  Is  some- 

135  times  broken  down  Into  several  parts,  particularly  If  the  problem 

136  Is  very  complex.  The  task  of  stating  the  problem  In  a clear  and 

137  unambiguous  form  Is  performed  by  an  analyst  or  system  analyst . 

138  The  technique  of  specifying  methods  of  solution  for  mathematical 

139  problems  Is  mathematical  analysis  or  numerical  analysis . A 

140  specific  procedure  for  solving  a problem  Is  an  algorithm.  The 

141  process  of  writing  the  detailed  step-by-step  Instructions  for  the 

142  computer  to  follow  Is  coding  done  by  a coder. 

143  After  a program  Is  written.  It  Is  tested  by  letting  It  perform  Its 

144  function  In  the  computer  on  test  data  to  which  the  proper  solution 

145  Is  known.  This  process  Is  code  checking  or  debugging.  The  coder 

146  will  also  produca  soma  descriptions  of  this  program  and  how  It 

147  operates  so  that  others  may  understand  how  It  works.  In  case  at 

148  a future  date  It  Is  necessary  to  modify  It.  This  documentation 

149  may  Include  a flomckarti  a graphic  description  or  diagram  of  the 

150  various  paths  and  branches  followed  by  the  program. 

151  The  repertory  of  Instructions  available  to  the  programmer  for  a 

152  specific  computer  Is  that  computer's  machine  language . Other 

153  klgker-arder  languages  have  been  developed  to  help  the  programmer 

154  by  simplifying  the  tedious  aspects  of  writing  machine  language; 

rage  4 SarUe.  I 1.  A PROSK  CUSSART 
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155  these  are  called  procedurt  oriented  languages  or  problem  oriented 

156  languages  or  POL.  Commonly  used  POLs  are  Fortran,  Algol,  and 

157  Coboll  the  first  two  were  devised  mainly  for  scientific  computation 

158  and  the  latter  for  business  data  processing.  A new  type  Is 

159  represented  by  list  processing  languages;  because  of  greater  flexl- 

160  bllltles  In  dealing  with  data,  these  languages  are  particularly 

161  useful  In  nonnumerlc  computations  such  as  are  frequently  Involved 

162  In  research.  Their  particular  virtues  are  most  apparent  In 

163  heuristic  processes',  methods  where  the  precise  method  of 

164  solution  Is  not  spelled  out  but  Is  discovered  as  the  program 

165  progresses  and  ab  it  evaluates  Its  progress  toward  an  acceptable 

166  solution.  (Becauss  this  use  of  the  "language*  Is  somewhat  mis- 

167  leading,  human  languages  such  as  English  are  distinguished  as 

168  natural  languages . ) 

169  Programs  which  convert  higher-order  languages  Into  machine 

170  language  are  called  compilers;  programs  which  perform  similar 

171  functions  but  at  a much  simpler  level  are  assemblers.  The  term 

172  translator  Is  used  sometimes  for  a compiler,  but  It  Is  used  less 

173  frequently  because  of  the  possible  confusion  with  programs 

174  which  perform  translation  between  natural  languages.  Interpreters 

175  do  not  compile  the  entire  program  but  translate  end  perform  one 

176  stateaient  of  the  program  at  a time;  effectively,  they  perform  both 

177  functlons-complling  and  running  a program. 

178  Software  Is  the  term  used  to  refer  to  the  totality  of  programs  and 

179  procedures  available  on  a computer;  sometimes  It  us  used  more 

180  specifically  to  mean  those  programs  of  general  usefulness  (such 

181  as  compilers)  which  are  available  to  all  users.  These  are  some- 

182  times  called  utility  programs . All  machines  today  have  operat- 

183  ing  systems  to  aid  the  user  (and  the  operator)  In  sequencing  Jobs, 

184  accounting,  and  calling  up  other  utility  programs.  Operating 

185  systems  or  programs  are  also  called  control  programs,  super- 

186  visors  or  executives. 

187  Applications  are  the  problems  to  which  a computer  Is  applied;  the 

188  names  for  most  common  applications  are  self-explanatory,  but  some 

189  are  not.  A simulation  Is  the  representation  of  a real  or  hypo- 

190  thatlcal  system  by  a computer  process;  Its  function  Is  to  Indicate 

191  system  performance  under  various  conditions  by  program  perfor- 

192  mance.  Information  retrieval  Is  the  name  applied  to  processes 

193  which  recover  or  locate  Information  In  a collection  of  documents. 

194  An  information  management  system  helps  a user  maintain  a data 

195  base,  modify  It,  and  get  reports  from  It.  It  Is  usually  defined 

196  as  a general  purpose  device;  this  means  that  It  can  accommodate 

197  a large  range  of  applications.  A management  information  system 
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198  supplied  to  the  Mneaement  of  en  organization  the  data  that  It 

199  requires  to  Make  decisions  and  to  exercise  control.  A report 

200  generator  Is  a prograM  which  allows  the  user  to  specify  In  some 

201  simple  way  the  content  and  format  of  reports  which  the  computer 

202  Is  to  produce. 

203  To  run  a program  Is  to  cause  It  to  be  performed  on  the  computer. 

204  Running  a program  to  solve  a problem  or  produce  real  results  (as 

205  opposed  to  debugging)  Is  called  a production  run . Installations  In 

206  which  the  us6r  runs  his  own  Job  are  called  open  shops.  Installations 

207  which  have  a computer  operator  who  runs  the  programs  for  the 

208  user  are  closed  shops.  Computers  are  usually  operated  In  batch 

209  processing  mode,  the  operator  assembles  a batch  of  programs 

210  waiting  to  be  run  and  puts  them  serially  Into  the  computer;  output 

211  from  all  the  programs  Is  returned  In  one  batch.  Turnaround 

212  time  Is  the  time  between  the  user's  delivering  his  Job  to  the  center 

213  and  his  receipt  of  his  output.  Timesharing  Is  a method  of  operation 

214  by  means  of  which  several  Jobs  are  Interleaved,  giving  the 

215  appearance  of  simultaneous  operation.  In  many  timeshares  systems, 

216  users  have  Individual  terminals  which  are  on-line.  Such  terminals 

217  may  be  located  far  from  the  computer;  this  Is  remote  access . 

218  This  allows  users  to  Interact  with  the  computer  on  a time  scale 

219  appropriate  for  human  beings — on  the  order  of  a few  seconds 

220  between  responses.  This  capability  Is  called  operating  In  real 

221  time.  Using  the  computer  for  frequent  Interaction  with  the  user 

222  In  this  way  Is  called  an  interactive  or  conversational  mode  of 

223  computing. 

224  Like  all  electronic  devices,  computers  sometimes  break  down. 

225  The  prevention  and  correction  of  such  situations  Is  maintenance. 

226  Preventive  maintenance  finds  falling  components  before  they 

227  actually  break  down.  Reliability  Is  the  measure  of  the  frequency 

228  of  failure  of  the  computer.  During  downtime  the  machine  Is 

229  being  maintained  or  repaired;  during  uptime  It  Is  available  for 

230  normal  productiva  use. 
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TFRM  ind  (LINE) 
access  speed  (32) 

Algol  (1S6) 
algorithm  (140) 
analog  computer(s)  (2) 
analyst  (137) 
appllcatlon(s)  (187) 
assembler(s)  (171) 

batch  processing  mode  (208) 
binary  number  (99) 
bit  (27) 
branching  (124) 
byte(s)  (30) 

capacity,  storage  (2S) 
card,  Hollerith  (47) 
card  punch  (80) 
card,  punched  (47) 
card  reader (s)  (48) 

cathode  ray  tube  (68) 
cell(s)  (26) 


TERM  and  (LINE) 
data  bank  (129) 
data  base  (129) 
debugging  (145) 
deck  (52) 

digital  computer(s)  (5) 
disc,  magnetic  (22) 
display  device  (66) 
documentation  (148) 
downtime  (228) 
drive,  tape  (77) 
drum,  magnetic  (21) 

EAH  (86) 

EOF  (9) 

electromechanical  accounting 
machlne(s)  (86) 
electronic  data  processing 
machlnes(s)  (9) 
executlve(s)  (186) 

feedback  (111) 


file  (128) 
flowchart  (149) 
Fortran  (156) 


central  processing  unit  (12) 
character(s)  (103) 
closed  shop(s)  (200) 

Cobol  (157) 
code  checking  (145) 


general  purpose  device  (196) 


coded  (102) 

coder  (142) 

coding  (142) 

column(s)  (51) 

cofflmand(s)  (104) 

compller(s)  (170) 

computer  ( 1 ) 

computer,  analog  (2) 

computer,  digital  (5) 

computer  operator  (207) 

computer,  stored  program  (114) 

console  (93) 

control  pragram(s)  (105) 

conversational  mode  (222) 

core  memory  (15) 

cora(s)  (18) 

CPU  (12) 

CRT  (60) 


hard  copy  (71) 
hardware  (11) 

heuristic  process(es)  (163) 
higher-order  language(s)  (153) 
Hollerith  card  (47) 


Information  management 
system  (194) 

Information  retrieval  (192) 
Input  devlce(s)  (45) 
Input/output  equipment  (44) 
Instructlon(s)  (104) 
Interactive  mode  (222) 
Interpreter(s)  (174) 

I/O  (44) 


keypunch  (89) 


languag*,  lt1ghar>ordar  (153) 
languaga,  list  procassing  (159) 
languaga,  laachlfta  (152) 
languaga,  natural  (IM) 
languaga,  problaw 
orlantad  (155) 
languaga.  procadura 
orlantad  (155) 
library  (117) 
llna  printar  (63) 
list  procassing  langusga(s)  (159) 
loop  (122) 

nachlna  languaga  (152) 

Magnetic  d1sc(s)  (22) 

Magnetic.  druM(s)  (21) 

Magnetic  Ink  character 
readar(s)  (55) 

Magnetic  tape  (74) 

Main  frana  (12) 

Maintenance  (225) 

Maintenance,  preventive  (226) 
ManagoMont  Infornatlon 
systoM  (197) 

MatheMatIcal  analysis  (139) 
MOMory  (14) 

MOMory.  core  (15) 

Mlcrosacond(s)  (39) 
Mllllsacond(s)  (38) 

nanosacond(s)  (39) 
natural  languaga(s)  (168) 
numerical  analysis  (139) 

orr-11na  (82) 
on-line  (81) 
open  shop(s)  (206) 
operating  systen(s)  (182) 
operator,  conputar  (207) 
optical  scanner(s)  (57) 
output  devlco(s)  (60) 


procedure  oriented 

language(s)  (155) 
processor  (9) 
production  run  (205) 
program  (107) 
program,  control  (185) 
program,  utility  (182) 
programmer  (133) 
punch,  card  (60) 
punch,  tape  (61) 
punched  card  (47) 
punched  paper  tape  (52) 

random  access  (33) 
reader,  card  (48) 
reader,  character, 

magnetic  Ink  (55) 
reading  (49) 
real  time  (220) 
reglster(s)  (26) 
reliability  (227) 
remote  access  (217) 
report  generator  (199) 
reproducer  (89) 
routlne(s)  (115) 
run  (203) 

run,  production  (205) 

serial  access  (35) 

simulation  (189) 

software  (178) 

sorter  (90) 

speed,  access  (32) 

step(s)  (120) 

storage  (14) 

storage  capacity  (25) 

stored  program  computer  (114) 

subroutlne(s)  (115) 

supervlsor(s)  (185) 

system  analyst  (137) 
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paper  tape,  punched  (S2) 
paraiaater(s)  (127) 
peripheral  equlpiaent  (6$) 
plotter  (71) 

POL  (156) 

preventive  Mintenance  (226) 
probleia  oriented 

lanouaoe(a)  (155) 
upttM  (229) 
utility  pro9raai(a)  (182) 


table(s)  (126) 
tape  drive  (77) 
tape,  Magnetic  (74) 
tape  punch  (61) 
tape,  punched  paper  (52) 
ternlnal  (93) 
tine  sharing  (213) 
translator  (172) 
turnaround  tine  (211) 
word(s)  (26) 

%rard  length  (28) 
tn-UIng  (66) 
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The  ARPANET  is  an  operational,  compnteriaed.  packet  switchinf  OoD  digital  network 
which  provides  a capability  for  terminab  or  geographically  separated  computers,  called 
hosts,  to  communicate  with  each  other. 

The  elements  of  the  network  are  the  Interface  Message  Processors  (IMP).  Terminal  Interface 
Processors  (TIP),  access  lines,  host  computers  and  terminals. 

The  host  computers  typically  differ  from  one  another  in  type,  speed,  word  length,  and 
operating  system.  Each  terminal  or  host  computer  is  connected  Into  the  network  through  a 
local  small  computer  called  an  IMP  (a  store  and  forward  packet  switch  which  will 
accommodate  up  to  four  host  computers)  or  TIP  (a  store  and  forward  packet  switch  which 
will  accommodate  up  to  S host  computers  and  C4  terminals). 
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The  complete  network  Is  formed  by  interconnecting  the  IMP'S  through  wideband 
communication  Nncs  (SOKB)  supplied  by  common  carriers.  Each  IMP  and  TIP  Is 
programmed  to  receive  and  forward  messages  to  the  neighboring  IMP’S  or  TIP's  In  the 
network. 

During  a typical  host-to-host  operation,  a host  passes  a message  to  Its  IMP;  the  message  is 
passed  from  IMP  to  IMP  through  the  network  until  it  finally  arrives  at  the  destination 
IMP,  which  passes  it  along  to  the  destination  host.  A terminal  (teletypewriter  or  CRT) 
accesses  the  network  through  a Terminal  Interface  Processor  (TIP)  and  sends  a message  to  a 
host  or  another  terminal  The  terminal  message  passes  through  the  network  In  the  same 
manner  as  • liost«todioet  message. 
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3.  TIP  USER’S  GUIDE 


The  followliif  was  excerpted  frem  USER’S  GUIDE  TO  THE  TERMINAL  IMP.  Bolt. 
Beranek  and  Newman.  Inc.  Report  Na  tl8S.  NIC  No.  10916.  July  1977  Revision. 


i.l  INTRODUCTION 


This  report  describes  the  use  of  a terminal  connected  to  a Terminal  IMP  (TIP)  in  the 
ARPA  Network.  The  report  assumes  that  the  user  knows  how  to  operate  a server  Host 
system  somewhere  on  the  network  once  he  becomes  connected  to  that  system,  and  the  report 
defines  the  procedures  and  options  the  user  has  available  to  establish  that  connection. 

The  ARPA  Network.  IMPs  and  TIPs,  hardware  maintenance,  TIP  operation,  and  formats 
and  protocols  arc  not  described  here.  The  bibliography  lists  the  relevant  documents. 

It  should  be  noted  that  the  TIP  is  designed  to  support  interactive,  asynchronous  terminals. 
It  cannot  normally  support  synchronous  devices,  or  devices  whose  input  (to  the  TIP) 
characteristics  are  significantly  different  from  a human  typist.  Thus  the  connection  of 
computers,  paper  tape  readers,  polled  circuits,  buffered  terminals,  and  so  on  to  TIP  ports  Is 
likely  to  be  difficult  or  impossible. 


S.2  THE  TIP  COMMAND  FORMAT 


The  user  at  a terminal  will  at  various  times  be  talking  directly  to  his  TIP  Instead  of  to  the 
remote  Host.  A typical  message  of  this  sort  might  look  Hke: 

tOPEN  IS 

Such  a command  always  starts  with  symbol  • and  ends  with  cither  a linefeed  or  a rubout, 
depending  on  whether  the  user  Is  satisfied  with  the  command  or  wishes  to  abort  It.  On  9741 
terminals  the  return  key  transmits  carrlage-rctnm/  linefeed  to  the  TIP  and  ASCII  terminals 
are  normally  operated  In  a mode  where  typing  a carrlagc^nm  Is  Interpreted  as  carriage* 
return/Hncfccdi  both  can  be  used  to  terminate  TIP  commands  In  addition  to  a Hncfeed 
alone.  The  on^  exception  to  this  rule  Is  the  specific  command 
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wkldi  Inwrt*  an  • In  tli«  data  stream  to  the  Host.  Commands  may  occnr  anywhere,  and 
need  not  start  on  a new  Hne.  Upper  and  lower  case  may  be  freely  Intermixed  In  the 
command. 

Between  the  • and  the  linefeed  there  will  typically  be  one  or  more  words  to  Identify  the 
command,  perhaps  followed  by  a sinfle  parameter.  The  TIP  Is  not  very  sophisticated,  and 
thinks  the  only  Important  thinf  abont  a word  Is  Its  first  letter.  This  permits  the  nser  to 
abbreviate  a biti  the  more  nsnal  renderinf  of  the  first  example  might  bet 

90  15 

Once  the  user  has  started  typing  the  parameter  of  a command  the  old  value  of  the 
command  wlH  have  been  destroyed,  and  cannot  be  recovered  by  aborting  the  command. 

Almost  withoot  exception  the  effect  of  a TIP  command  Is  to  set  a parameter  or  mode  for 
the  terminal  Even  apparently  direct  commands  like 

tOPEN  15 

(which  Initiates  an  elaborate  exchange  of  messages  resulting  In  a connection  to  the  remote 
Host  system)  actoaHy  set  a mode  flag  to  request  the  appropriate  action  when  the  TIP  Is  free 
to  undertake  H.  To  understand  the  TIP  behavior  is  really  to  understand  the  complete  set  of 
parameters  and  the  commands  to  change  them.  Normally,  any  parameter  can  be  changed 
at  any  time  by  the  user  at  bis  terminal  Exceptions  occur  when  the  user  tries  to  change 
connection  parameters  on  an  open  connection.  An  oOPEN  IS  executed  while  talkinf  to 
Host  15  would  generate  the  error  message  XanV  (the  connection  to  Host  15  must  be  closod 
before  a connection  can  be  opened  to  Host  ItX 

Commands  often  consist  of  several  command  wordsi  for  example, 

•DEVICE  CODE  ASCII 

Such  commands  may  be  abbrevlatedt  for  example 

•OCA 

The  spaces  are  tequiredt  aDCA  Is  not  a legal  command.  Upper  and  lower  cam  lattara  may 
be  freely  Intermixed. 

An  unusual  variation  In  command  format  Is  to  place  a number  between  the  • and  the  first 
word  of  the  command.  In  this  case,  the  command  Is  not  meant  for  the  terminal  typing  but 
for  the  terminal  attached  to  the  port  of  that  number  on  the  mme  TIP  as  the  near. 
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S.S  TYPICAL  USE  OF  THE  TIP 


In  tkr  normal  course  of  things,  a user  will  go  through  four  more  or  less  distinct  stages  In 
typing  Into  the  net.  First,  he  will  be  concerned  with  hardware-power,  dialing  In,  etc.  Then 
he  will  establish  a dialogue  with  the  TIP  to  get  a comfortable  set  of  parameters  for  this 
usage.  Next,  he  will  instruct  the  TIP  to  open  a connection  to  a remote  Host;  and  finally,  he 
will  mostly  Ignore  the  TIP  as  he  talks  to  the  remote  Host.  The  following  sections  will 
describe  these  stages  In  more  detail. 


S.4  ESTABLISHING  PARAMETERS 


In  stage  two,  the  user  Is  concerned  with  initialising  parameters.  The  naive  user  should  skip 
stage  two  and  accept  the  TIP's  default  parameters  until  an  obvious  problem  arises.  The 
foHowIng  questions  are  answered  In  stage  two. 

1.  IF  Am  tkatt  the  TIP  send  off  messages  to  the  remtde  Host!  Here  there  are  several  options. 
(The  TIP  Is  Inlliallicd  to  send  on  every  character,  which  Is  simple  but  Inefficient.) 

•TRANSMIT  NOW 
•TRANSMIT  ON  MESSAGE-END 
•TRANSMIT  ON  LINEFEED 
•TRANSMIT  EVERY 

TRANSMIT  NOW  causes  the  message  currently  being  accumulated  to  be  sent  as  soon  as 
possible.  TRANSMIT  ON  MESSAGE-END  causes  a message  to  be  sent  as  soon  as  possible 
after  an  ASCII  DCS  (control-C)  Is  encountered.  TRANSMIT  ON  LINEFEED  causes  a 
message  to  be  sent  as  soon  as  possible  after  a linefeed  Is  encountered.  Additionally,  both 
TRANSMIT  ON  MESSAGE-END  and  TRANSMIT  ON  LINEFEED  cause  characters  to  be 
accumulated  In  the  message  buffer  until  It  Is  almost  full.  TRANSMIT  EVERY  causes  a 
message  to  be  sent  as  near  as  possible  to  every  th  character.  The  command  TRANSMIT 
EVERY  • WIN  reset  the  TIP  to  its  initial  state,  transmitting  every  character.  If  the 
parameter  to  TRANSMIT  EVERY  a Is  a large  number  (e.g..  2S0)  the  TIP  will  save  up  as 
many  characters  as  It  can  before  sending  a message,  but  does  not  offer  any  guarantee  that 
the  total  number  specified  can  be  buffered. 

t.  Who  shall  oeho  and  mhenf  Echoing  Is  a complex  problem,  without  any  neat  solution.  We 
baoe  chaaen  in  give  the  user  the  means  to  tell  the  TIP  how  he  or  she  wants  It  done,  since  It 
Is  bard  In  guess  correctly  In  advance.  Basically,  echoing  can  occur  at  the  terminal  hardware. 
In  Ibo  TIP.  or  In  the  remote  Host  The  corresponding  TIP  commands  arcs 
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(Echo  at  the  remote  Host) 


Each  mf  these  comMaNds  sets  the  internal  state  of  the  TIP  to  the  correct  mode,  and  In 
addltHm  sends  the  appropriate  TELNET  command  to  the  Host  if  the  connection  is  open 
orhen  the  command  Is  fiven.  The  commands  ECHO  ALL  and  ECHO  NONE  are  now 
exactly  equivalent  to  ECHO  LOCAL  and  ECHO  REMOTE;  they  have  been  left  temporarily 
while  users  become  accustomed  to  the  new  usafe. 

In  the  ECHO  REMOTE  mode,  although  characters  for  the  remote  Host  are  not  echoed,  the 
TIP  will  echo  commands.  Network  protocol  specifies  that  echoing  shall  start  out  In  the 
•ECHO  LOCAL  or  nECHO  HALF  modes.  The  TIP  will  try  to  guess  from  the  terminal 
type  which  of  the  two  Is  appropriate.  The  goal  of  the  echoing  strategy  is  to  avoid  the 
unreadable  alternatives  of  the  blank  page  and  the  doubling  of  every  character.  The  naive 
user  Is  advised  to  accept  the  TIP’s  default  parameters  until  trouble  of  this  sort  arises.  A 
<741  cannot  change  echo  mode  and  is  always  halfduplex. 


Because  both  the  TIP  and  the  remote  Host  need  to  agree  on  who  is  to  echo  the  characters, 
the  TELNET  protocol  prorUei  a mechanism  whereby  the  remote  terminal  user  may 
instruct  the  serving  Host  to  set  a particular  mode  and  vice  versa,  the  remote  Host  may 
instruct  the  TIP.  As  noted  above,  this  happens  automatically  when  the  command  Is  given 
by  the  user  while  the  connection  is  open.  But  the  Host  too  may  issue  such  commands  to  the 
TIP.  and  the  TIP  is  not  able  to  refuse  the  request  (even  for  2741  terminals).  If  the 
connection  becomes  established  In  an  undesirable  mode,  the  user  may  change  this  by  one  of 
the  echo  commands  above 


LS  GONNECTION  TO  REMOTE  SITES 


In  stage  three,  the  user  Is  concerned  with  establishing  a connection  to  a remote  site 


This  amounts  to  "set  the  Host  number  parameter”  and  'add  the  user  to  the  queue  of  users 
waiting  for  the  TIP's  connection  mechanism”. 

Currently.  Host  addresses  are  single  decimal  numbers,  as  shown.  Additionally  the  TIP 
accepts  0 two  number  Host  address  as  followst 


<Host  # on  tho  INP>/<IHP  #> 
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Lradlnf  ktm  are  not  rMjnlred.  Therefore,  for  example, 
arc  all  MentkaL 


•Host  44,  sHoat  <V44  or  •Hoot  /44 


Connectlnf  to  a. Host  requires  establishlaf  a bl<directlonal  link,  so  that  the  terminal  can 
send  characters  to  the  Host  and  eke  versa.  The  reqnest  to  connect  to  a Host  is  thus  really  a 
request  to  cstabNsb  both  transmit  and  receive  sections. 

When  the  user  reaches  the  head  of  the  queue  waiting  for  the  TIP’s  ’’connection"  mechanism, 
the  TIP  will  type  "Trylnf~.*. 

Following  the  message  Trying",  the  user  will  receive  some  of  the  following  messages: 

Open  success* 

Nat  Trouble  renota  site  cannot  ba  raachad 

Rafusad  ranota  sita  up  but  rafusing 

Host  Schadulad  Down  Until  Sat.  at  1850  6NT 

Host  will  ba  back  up  at  tine  and  data 
indicated 

Host  Unschodulad  Down  Until  Sat.  at  1850  6NT 

Host  will  back  up  at  tine  and  date 
indicated 

Host  not  responding 

Remote  sita  not  up,  unknown  whan  up 
service  will  resume 
ICP  Inter fared  With 

The  Host  has  not  perforiMd  the  ICP 
correctly  and  the  TIP  has  refused 
to  open  a connection. 


{♦"Open"  indicates  both  halves  of  the  TELNET  connection  have  been  opened 
simultaneously.  Sometimes  tlpen  R"  followed  by  "Open  T"  (or  vice  versa)  will  be  printed^ 
this  too  Indicates  both  halves  of  the  connection  have  been  opened,  but  not  simultaneously. 
If  only  "Open  R"  or  "Open  T"  Is  printed,  then  the  server  Host  has  failed  to  open  one  half  of 
the  TELNET  connection.] 

The  connection  mechanism  wili  run  continuously  until  a state  described  above  occurs.  This 
can  be  annoying  when  the  remote  site  Is  obviously  not  going  to  respond.  The  command 


tCLOSe 


will  abort  the  current  connection  attempt  The  user  Is  then  free  to  reattempt  to  open  the 
connection  or  to  attempt  to  open  a connection  to  some  other  Host 
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The  TIP's  connection  mechanism  has  caused  users  some  problems.  Perhaps  a discussion  of 
what  the  connection  mechanism  is  doin|[  and  how  it  works  will  alleviate  some  of  the  grief. 

First  of  alh  users  attempting  to  connect  to  different  Hosts  will  never  interfere  with  each 
other,  although  users  simultaneously  attempting  to  connect  to  the  same  Host  will  be 
serviced  serially. 

For  the  user,  opening  proceeds  in  three  phases.  In  the  first,  the  user  is  queued  up  waiting  to 
"get"  the  TIP’s  connection  mechanism.  In  the  second,  the  user  has  gotten  the  TIP’s 
connection  mechanism  and  is  beginning  the  connection  sequence.  In  the  third,  the  user  has 
completed  the  connection  sequence  and  is  waiting  for  the  Host  to  open  up  the  actual  data 
connections.  Many  of  the  problems  stem  from  the  fact  that  only  one  user  may  be 
proceeding  through  phase  t at  a given  time  to  a given  Host.  Hence  the  the  TIP  types  out 
"Trying"  when  you  get  off  the  queue  and  the  connection  mechanism  begins  trying  to  open 
your  connections.  Thus  the  "Trying"  message  signifies  the  transition  from  phase  1 to  phase 


S.S  USE  OF  REMOTE  SITES 


In  stage  four,  the  user  is  normally  talking  to  the  Host  without  concern  for  the  TIP.  All  the 
TIP  commands  are  still  available. 


One  command  that  will  eventually  be  of  interest  here  is 


•CLOSE 


This  command  starts  the  shut-down  procedure.  The  TIP  will  echo  "Closed"  when  the 
process  is  finished.  "Closed"  indicates  that  the  server  Host  agreed  to  close  both  halves  of  the 
TELNET  connection  simultaneously.  If  the  halves  of  the  connection  are  closed  one  after 
another,  "Closed  R"  followed  by  "Closed  T"  (or  vice  versa)  will  be  printed.  If  only  one  of 
"Closed  T"  or  "Closed  R"  is  printed,  wait  a minute  and  the  TIP  will  force  the  other  half  of 
the  connection  to  be  closed. 


The  TIP  does  not  know  how  to  log  you  out  of  the  remote  Host.  You  must  do  this  youraelf 
before  closing  the  connection. 

To  return  to  the  nominal  mode  of  carriage-retnm/Hnefeed,  the  command 


•INSEIIT  LINEFEED 


should  bo  euccuted. 


If  at  any  (Ivan  time  tlie  nscr  typo  ckaractcrt  faster  than  a term  Host  will  take  them  from 
the  TIP.  the  TIP  discards  characters  It  can  not  hnffer  and  echos  them  with  an  A&CII  BEL 
(on  a 2741,  the  type  element  Is  wiffled). 


The  nscr  may  sometimes  nsc  a server  Host  with  whkh  it  is  desirable  not  to  have  • be  a TIP 
reserved  character.  The  nser  can  chanfe  the  character  which  introdnees  TIP  commands 
using  the  command 


By  typing  alNTERCEPT  followed  by  a decimal  number  representing  an  ASCII  character, 
the  user  changes  the  TIP  command  character  for  his  device  to  the  ASCII  character 
represented  by  the  number.  The  INTERCEPT  ESC  command  resets  the  TIP  command 
character  to  atalgn  (•).  Thus. 


t INTERCEPT  47 
* INTERCEPT  ESC 


changes  the  TIP  command  character  to  asterisk  (s)  and  back  to  at*sign  (•)  assuming  the 
device  was  in  the  nominal  mode  (•)  before  the  first  command  was  executed. 


If  the  user  attempts  to  change  the  intercept  character  but  fails  to  type  a valid  decimal 
number  (or  a character  string  beginning  with  E)  the  TIP  will  type  the  diagnostic  "Num" 
and  will  aet  the  Intercept  character  to  at-sign. 


S.7  CONNECTION  LOSS  AND  RESTORATION 


Starting  with  TENEX  Hosts  running  Software  Version  1.S2.  if  TENEX  halts,  the  TIP  will 
notify  users  connected  to  it  of  this  fact  by  typing  ‘Connection  Suspended”.  [Other  Hosts 
may  also  implement  the  mechanisms  which  will  allow  the  suspension  and  restoration  of 
connections.)  At  this  point  the  users  are  free  to  do  one  of  two  things.  First,  they  can  wait 
till  TENEX  restores  service,  in  which  case  the  TIP  will  type  out  ‘Connection  Restored”  (or 
if  after  the  the  service  Interruption  the  connection  couM  not  he  restored,  the  TIP  will  type 
out  ‘Host  broke  the  connection”).  AHernativeiy.  the  user  is  free  to  open  a connection  to  any 
other  Host,  in  which  case  the  TIP  will  invisibly  dose  the  TENEX  connection.  It  is  also 
Important  to  point  out  that  If  a user  Just  leaves  bis  terminal  unattended  across  a TENEX 
service  outage  without  releasing  the  connectiou  (any  netsrork-related  command  such  as  aH, 
aO,  aN.  aC  will  do  the  Jab)  bis  Job.  directory,  etc.,  are  left  at  the  mercy  of  anyone  who 
acquiree  that  terminal 
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There  is  frequently  Information  which  the  group  developing  and  debugging  the  TIP  system 
wishes  to  convey  to  TIP  users.  For  instance,  when  a bug  is  detected,  we  may  wish  to  warn 
users  not  to  use  a certain  feature  until  the  bug  is  fixed.  When  a minor  improvement  is 
made,  we  may  wish  to  notify  users.  Further,  there  is  frequently  news  about  the  state  of  the 
networh  or  the  state  of  a particular  Host  which  should  be  conveyed  to  TIP  users.  Finally, 
TIP  users  may  wish  to  communicate  with  the  TIP  development  staff  or  the  Network 
Control  Center  staff  about  problems  or  suggested  improvements  for  the  TIP  or  the 
network.  Consequently,  we  have  constructed  a mechanism  which  we  hope  will  provide  for 
communication  in  all  the  above  directions.  This  mechanism  is  the  Network  Virtual  TIP 
Executive  (a  version  of  the  Resource  Sharing  Executive  being  developed  by  the  BBN 
TENEX  group).  To  activate  this  mechanism,  the  TIP  user  may  give  the  TIP  command  aN. 
This  command  causes  the  TIP  to  perform  the  necessary  protocol  to  make  a connection  to 
the  Network  Virtual  TIP  Executive  which  resides  on  several  of  the  network  TENEX 
systems.  Once  the  Network  Virtual  TIP  Executive  has  been  activated,  we  think  its 
operation  is  self-explanatory.  Presently  available  features  within  the  Network  Virtual  TIP 
Executive  are  a Network  News  feature,  a Host  Status  feature,  and  a "Gripe"  feature.  The 
latter  provides  users  with  a mechanism  for  sending  messages  to  the  TIP  development  or 
NCC  staffs.  We  recommend  that  TIP  users  get  the  network  news  at  the  beginning  of  every 
TIP  session. 

The  TIP  will  normally  prompt  the  user  to  consider  reading  the  news  by  typing  the 
messages 


Latest  net  news  DATE 

Use  *9N<cr>*  followed  by  "netnews<cr>'' 

at  some  point(s)  during  the  user's  session.  The  point  chosen  is  at  the  time  of  terminal 
recognition  for  'liunting*  terminals,  or  at  each  time  a connection  is  closed  for  "non- 
hunting"  terminals. 

When  a user  issues  an  wN  command,  the  TIP  requests  support  from  all  cooperating  servers. 
Thus,  the  user  should  be  able  to  reach  a news  facility,  somewhere,  almost  all  of  the  time. 
However.  In  the  event  that  no  cooperating  server  is  available  the  TIP  will  time  out  the  aN 
command  In  about  thirty  seconds.  An  wC  command  will  abort  an  sN  immediately. 

Of  course.  TIP  users  with  an  immediate  need  for  communication  with  the  NCC  or  TIP 
development  staffs  should  telephone  (odlect)  the  Network  Control  Center  (617-661-0100). 
Users  with  general  questions  questions  about  network  usage  (How  do  I find  out  if  Host  X is 
ever  going  to  be  up  againi  What's  happening  with  a Host/Host  protocol  for  graphics?)  may 
also  call  the  NCC 
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S.9  UNUSUAL  USES  OF  THE  TIP 


The  "usual"  use  of  a TIP  U to  connect  one  of  the  terminals  which  the  TIP  supports  to  a 
remote  Host.  We  have  tried  to  make  this  operation  as  easy  and  natural  as  possible  for  the 
user.  "Unusual”  uses  of  the  TIP  are  such  things  as  connecting  a non-standard  terminal, 
talhing  termlnaMo-termlnai.  or  using  unusual  protocols.  Such  uses  are  possible,  but  within 
the  constraints  of  the  TIP's  site  It  has  not  always  been  feasible  to  make  them  easy. 


9.10  THE  DIVERT  OUTPUT  COMMAND 


It  Is  possible  (with  some  care)  to  divert  the  output  intended  for  one  terminal  to  another 
terminal  Presumably  the  second  terminal  has  a desired  feature,  like  hard  copy  or  high 
speed.  The  command 


916  DIVERT  OUTPUT 

will  cause  all  remotely  generated  output  to  be  diverted  from  the  terminal  on  which  the 
command  was  typed  to  Terminal  IS.  This  state  will  continue  until  any  other  command  Is 
executed  at  the  diverting  terminal  (Executing  another  command  does  not  do  a Give  Back.) 
Local-echoing  will  not  be  diverted,  and  Input  may  proceed  at  the  diverting  terminal. 

This  mechanism  is  not  natural  to  the  structure  of  the  program.  In  particular,  the  buffer 
allocallon  structure  becomes  confused  if  the  diversion  aborts  while  output  Is  In  progress. 
Chained  diversion  will  also  confuse  the  TIP.  Please  don’t  try  these  things:  all  that  will 
happen  is  that  one  or  both  terminals  Involved  will  stop  responding.  In  fact.  In  general,  we 
discourage  use  of  the  DIVERT  OUTPUT  command  and  suggest  printing  to  TIP  devices 
other  than  the  user's  own  terminal  by  programs  such  as  the  TIPCOPY  program  which  runs 
on  many  network  TENEXs. 


9.11  EDITING 


At  the  moment  the  only  editing  command  available  Is 

9FLUSH 

which  deletes  all  the  characters  In  the  TIP's  Input  buffer.  In  current  practice  this 
command  Is  used  to  clear  out  any  odd  characters  stuck  In  a TIP  prior  to  giving  an  OPEN 
command.  (The  TIP  accumulates  characters  typed  in  during  periods  of  non-conncctlon  and 
sends  them  as  the  first  data  over  a new  connection.) 
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To  abort  a command,  type  a rubout  or  merely  make  something  about  the  command  illegal; 
for  example. 

90  X 

The  ’X"  aborts  the  OPEN  command. 


S.I2  THE  RESET  DEVICE  COMMAND 


The  reset  device  command  (aRESET)  will  restore  a port  to  its  initial  state.  Implicit  in  this 
command  is  the  concept  of  a "permanent  device."  Currently,  "permanent"  is  the  same  as 
"non-hunting"  but  this  will  not  always  be  so.  Permanent  devices  are  those  requiring  a 
particular  set  of  parameters  that' is  not  expected  to  change  or  perhaps  for  which  the  TIP 
cannot  hunt.  Examples  are  the  IMLAC  (no  high  speed  hunt)  and  a line  printer  (no  input 
possible).  Everything  is  reset  as  follows: 

a.  All  network  connections  and  attempts  to  open  connections 
are  cleared; 

b.  If  this  device  Is  captured  by  any  other  device,  that 
state  Is  cleared  and  If  this  device  Is  capturing  any 
other  devices,  that  state  Is  cleared; 

c.  Input  buffers  are  Initialized; 

d.  "Connection*  parameters  are  reset  to  a default  state* 

(I.e.,  echoing  all,  terminate  every  character,  no  Insert 
linefeed,  no  device  wild.  Intercept  all); 

e.  The  code,  rate,  and  size  are  set  to  the  hunting  state. 

r.  The  port's  data  set  Is  hung-up. 

g.  Sots  the  terminal  to  make  connections  under  OLD  TELNET 

protocol . 

For  permanent  devices  the  RESET  command  does  only  a,  b.  c.  f,  and  g above  and  prints 
"TIP  NAME"  followed  by  the  TIP  version  number  and  the  octal  port  number. 
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9.19  COMMAND  SUMMARY 

[a  DENOTES  A DECIMAL  NUMBER  UNLESS  OTHERWISE  STATED  ] 

BINARY  INPUT  END 

Leave  S-bit  binary  input  mode 
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BINARY  INPUT  START 


Enter  8-bit  binary  input  mode 
BINARY  OUTPUT  END 

Leave  8-bit  binary  output  mode 
BINARY  OUTPUT  START 

Enter  8-bit  binary  output  inode 
CLEAR  DEVICE  WILD 

Set  device  to  be  unwiid 
CLEAR  INSERT  LINEFEED 

Stop  inserting  linefeed  after  carriage-return 

CLOSE 

Close  all  outstanding  connections,  or  abort  current  Host  login 
DEVICE  CODE  37 

Establish  parity  computation  for  Model  S7  Teletype 
DEVICE  CODE  ASCII 


Establish  code  conversion  for  an  ASCII  terminal 
DEVICE  CODE  EXTRA-PADDING 


Capture  device  a and  divert  till*  terminafa  output  to  It.  a !•  an  octal  number. 
ECHO  ALL 

Local  TIP'generated  echo  - TIP  echoes  everything 
ECHO  HALFOUPLEX 

Terminal-generated  echo  ~ TIP  echoes  nothing 
ECHO  LOCAL 

Send  the  Telnet  "ECHO  LOCAL*  character  and  perform  internal  E A 
ECHO  NONE 

Remote  Host-generated  echo  for  data  - TIP  echoes  commands 
ECHO  RENOTE 

Send  the  Telnet  "ECHO  REMOTE*  character  and  perform  internal  E N 
FLUSH 

Delete  all  characters  in  input  buffer 
# GIVE  BACK 

Release  control  of  captured  device  a.  a is  an  octal  number. 

HOST  # 

Simultaneous  "aS  T H*  and  "aR  P H* 

INITIAL  CONNECTION  PROTOCOL 

Start  the  Initial  connection  protocol 
INSERT  LINEFEED 

Insert  linefeed  after  carriage-returns 
INTERCEPT  # 

Use  0 as  TIP  command  character 
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l.ravt  7>bit  binary  mode 
INTERCEPT  NONE 

Enter  7«blt  binary  mode 
LOGIN  # 

An  obsolete  form  of  OPEN 

N # # 

Maf  tape  command  o with  arfoment  a 
NE  TNORK-VIRTUAL-T  IP-EXECUTIVE 

Connects  the  nser  to  the  Network-VIrtnahTIP-Exccntive. 

OPEN  # 

Open  a bl-directlonal  connection  to  the  Host  decimal  address  specified. 
PROTOCOL  BOTH 

Simultaneous  ‘aP  T T”  and  ”«P  T R* 

PROTOCOL  TO  RECEIVE 

Manually  Initiate  connection  protocol 
PROTOCOL  TO  TRANSNIT 

Manually  Initiate  connection  protocol. 

RECEIVE  FROH  HOST  # 

Establish  Host  a parameter  for  manual  Initialiution. 

RECEIVE  FROM  SOCKET  # 


D 

0 
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Establish  socket  o parameter  for  manual  InitlallMtIon  of  connection  ~ socket  o 
Is  given  In  octal 
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RECEIVE  FROH  VILO 

Equivalent  to  "aR  F S <any>". 

RESET 

Reset  current  TIP  port  parameters. 

RESET  NCR 

Resets  NCP. 

SEND  BREAK 

Send  the  Telnet  '’BREAK*  character. 

SEND  COHNAND 

Send  the  command  escape  character. 

SEND  SYNC 

Send  the  Telnet  *SYNC*  character  and  an  "INTERRUPT  SENDER*  message. 
SEND  TO  HOST  # 

Establish  Host  a parameter  for  manual  initialiution  of  connection. 

SEND  TO  SOCKET  # 

Establish  socket  • parameter  for  manual  initialiiation  of  connection  - socket  • 
is  given  In  octal. 

SEND  TO  WILD 

Equivalent  to  *«S  T S <anjr>*. 

SET  DEVICE  WILD 

Equilvalent  to  the  commands  "sR  F H <an]r>*.  *aS  T H <any>*.  *«S  T S <anjr>”. 
and  "aR  F S <any>*. 

TRANSMIT  EVERY  # 

Send  off  Input  buffer  at  least  every  ath  character  where  f<a<tSS. 
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TRANSNIT  NOU 
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Send  off  Inpnt  bnffer  nnw. 

TRANSHIT  ON  LINEFEED 

Send  Inpnt  bnffer  every  time  ■ linefeed  U enconntered. 
TRANSNIT  ON  NESSA6E-EN0 

Send  Inpnt  bnffer  every  time  an  end^'MeiMfe  U enconntered. 
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9.19  TERMINALS  USED  WITH  THE  TIP 


The  following  terminals  are  reputed  to  have  worked  with  the  TIP. 

A.  B.  DICK  VIDEOJET  9600  LINE  PRINTER  (2400  bps) 
ANDERSON- JACOBSON  (Models  630  and  641) 

ARDS 

ICSR-3S  Teletype 
CALCOtIP  SOS 

GDI  1030/  "NULTICS*  Ternlnal 
DATA  100  (Model  73) 

DATAPOINT  (Models  2200,  3000,  and  3300) 

DELTA  TELTERN  2 

DIGITAL  EQUIPMENT  CORP.  (Models  VTOS  and  6T40A) 

EDT  1200 
HA7ELTINE  2000 
LINEOLEX  (Model  A) 

HFHOREX  1240 
SUGARMAN  (Model  S-4300) 

TECTRAN  CASSETTE 

TEKTRONICS  (Models  4010  and  4013) 

TELETERN  (Model  1030) 

TELETYPE  (MODEL  3B) 

TERMINET  300 
TI  Silent  700 
TYCOM 

TRENDATA  (Model  1000) 

UNIVAC  DCT  SOO 

VIDEO  SYSTEMS  (Models  1200  and  SOOO) 

We  would  be  pleased  to  hear  of  any  other  terminals  that  have  operated  on  a TIP. 
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At  the  International  Conference  on  Computer  Communications  held  in  Washington,  D.C., 
in  October  1972.  we  had  the  opportunity  to  personally  test  a number  of  the  above  terminals 
with  the  TIP.  As  a result  of  this  experience  we  now  hold  opinions  as  to  the  methods  and 
difficulty  of  connecting  a number  of  these  terminals  to  the  TIP.  We  suggest  you  call  the 
Networh  Control  Center  to  be  put  in  touch  with  someone  about  this  subject. 


9.16  NEW  TELNET  PROTOCOL  IMPLEMENTATION 


The  NEW  TELNET  protocol  has  been  implemented  in  TIP  systems  numbered  greater  than 
950.  Wherever  possible,  the  TIP  should  appear  Just  the  same  to  the  user,  but  some 
differences  do  occur.  Some  background  information  is  perhaps  useful.  Both  protocols  are 
based  on  the  concept  of  the  NETWORK  VIRTUAL  TERMINAL;  each  also  defines 
TELNET  commands  that  may  be  sent  to  instruct  the  other  side,  for  instance,  concerning 
echo  mode.  In  the  OLD  TELNET,  such  commands  are  unequivocal  demands,  and  cannot  be 
refused  even  If  the  state  is  undesirable.  A Host  can  of  course  undo  the  state  with  a counter 
command  of  Its  own.  but  it  first  must  understand  what  has  happened;  in  addition,  there  is 
no  guarantee  that  the  same  sequence  won’t  occur  again.  The  NEW  TELNET  protocol 
defines  a minimal  default  set  of  parameters,  then  allows  each  side  to  n^otiate  for  non* 
standard  options.  No  Host  Is  required  to  accept  an  undesirable  state;  in  fact,  a Host  can 
simply  refuse  to  do  "whatever  the  other  side  requested"  and  need  not  even  understand  what 
it  has  Just  refused.  This  protocol  should  allow  sophisticated  Hosts  to  define  complex 
lotions  without  burdening  simpler  Hosts, 

A direct  Implication  to  the  TIP  user  is  that  a "command"  Is  now  a "request"  and  may  be 
refused.  It  Is  possible,  for  instance,  to  ask  for  remote  echoing  (local  echo  is  the  default)  and 
not  get  It.  In  practice,  systems  provids  the  same,  or  increased,  capabilities  under  the  new 
protocol. 

On  the  positive  side,  the  TIP  now  acts  as  an  advocate  for  the  remote  terminal  user.  In  the 
case  of  a halfduplex  terminal  like  the  2741,  the  TIP  can  refuse  to  accept  the  remote  oebu 
option  and  the  user  no  longer  needs  to  cope  with  double  ceboing  when  tbe  connection  opens. 

Tbe  NEW  TELNET  protocol  specifically  affccU  tbe  foNowIng  napecto  of  tbe  TIP. 


9.16.1  Getting  In  and  Out  of  NEW  TELNET  Mode 

Tbe  commands  oOLD  TELNET  and  aNEW  TELNET  act  tbe  TIP  to  expect  OLD  or  NEW 
TELNET  respectively.  Tbe  defauM  as  of  tbia  writing  la  OLD  TELNET,  and  allESET 
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automatically  returns  the  device  to  OLD  TELNET  for  all  devices.  This  action  also  occurs 
when  a non-permanent  — that  is.  hunting  — lermlnjil  hunts  to  its  correct  rate. 

The  TIP  saves  this  mode  state  for  each  device.  When  a command  is  given,  for  say  echo  or 
binary,  the  TIP  determines  which  protocol  the  device  Is  using  and  responds  appropriately. 


S.16.2  Echoing 


The  TIP  echo  commands  have  the  same  meaning  in  NEW  TELNET  as  in  OLD  TELNET,  as 
revised  above.  In  addition,  the  TIP  now  remembers  the  mode  that  the  user  desires,  even 
though  it  may  not  be  possibie  to  be  in  that  state  at  the  time.  If  the  command  is  given 
when  a connection  is  open,  the  effect  is  the  same  as  OLD  TELNET,  with  the  TIP  sending 
the  request  to  the  remote  Host.  If,  however,  the  command  is  given  while  the  connection  is 
closed,  the  TIP  will  save  the  user's  request  and  send  it  to  the  remote  Host  automatically, 
each  time  a connection  opens. 

Non-hunting  terminals  will  continue  to  be  pre-initialized  as  arranged  by  the  designated  site 
representative  and  the  Network  Control  Center.  Most  hunting  terminals  will  default  to 
remote  echo  mode;  however,  physical  halfduplex  terminals  (27dls)  will  not  accept  remote 
echoing  ever,  whether  hunting  or  not. 


S.I6.S  Binary  Input  and  Output  Options 

Binary  Input  and/or  binary  output  are  available  under  the  NEW  'TELNET  protocol.  The 
commands  are: 

PRIMARY  INPUT  START  begins  binary  input  node 
•BINARY  INPUT  END  ends  binary  input  node 

•BINARY  OUTPUT  START  begins  binary  output  node 
•BINARY  OUTPUT  END  ' ends  binary  output  node 


As  with  the  echo  option,  the  TIP  sets  an  internal  flag  for  the  mode  the  user  wishes,  and 
attempts  to  get  the  remote  Host  to  agree.  This  feature  is  not  yet  automatic:  the  TIP  will 
not  send  a request  unless  the  connection  is  open  at  the  time  of  the  command,  but  the  TIP 
will  passively  accept  a request  for  binary  mode  from  a remote  Host  until  the  user  ends 
binary  mode.  This  may  be  useful  for  paper  tape  punches,  for  example. 
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S.16.4  Log  or  Open  • Connection 
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The  aOPEN  and  sLOC  commands  will  automatically  determine  the  appropriate  socket  for 
the  ICP  and  the  TIP  will  interpret  the  correct  TELNET  protocol. 

NOTE:  when  connections  are  made  directly  (and  not  through  the  LOG  or  OPEN 
commands),  the  user  should  take  care  to  In  the  proper  TELNET  mode.  An 
example  might  be  a lineprinter  or  paper  tape  punch  set  wild.  Any  program 
connecting  to  such  devices  must  use  the  same  TELNET  protocol  that  the  device 
Is  set  to. 


S.1S.S  Commands  Available  Under  NEW  TELNET 


These  commands  send  the  following  "New  Telnet"  function  codes:  Abort  Output  (AO).  Are 
You  There  (AYT),  and  Interrupt  Process  (IP).  To  use  these  commands  type: 

9SEND  ABORT  OUTPUT 

BSEND  ARE  YOU  THERE 

tSEND  INTERRUPT  PROCESS 

The  following  commands  cause  the  TIP  to  send  the  "New  Telnet"  function  codes  for  Erase 
Character  and  Erase  Line  to  the  remote  Host;  If  no  connection  Is  open  when  the  commands 
arc  given,  they  have  no  effect. 
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tSEND  ERASE  CHARACTER 
BSEND  ERASE  LINE 


The  command: 


BECHO  REMOTE  CONTROLLED 

requests  the  TIP  to  negotiate  with  the  remote  Host  for  Remote  Controlled  Transmission 
and  Echoing  mode  (RCTE)  for  that  port.  In  this  mode,  the  TIP  does  most  of  the  echoing, 
but  under  Instructions  from  the  Host.  As  examples,  the  Host  could  Instruct  the  TIP  to 
suppress  echoing  of  a password  or  have  the  TIP  hold  off  echoing  temporarily  while  the 
Host  performs  command  completion  (available  on  some  Host  systems).  Like  the  other  New 
Tcliict  echo  modes,  the  TIP  will  remember  that  RCTE  was  requested  and  automatically 
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negotiate  for  the  option  when  a new  connection  opens.  To  leave  RCTE  mode,  simply  give 
the  TIP  one  of  the  other  echo  mode  commands.  Physical  half-duplex  terminals  by  their 
nature  cannot  use  RCTE  mode.  NOTE:  few  Hosts  implement  RCTE  mode  at  present  and 
neither  they  nor  the  TIP  are  guaranteed  to  work  perfectly  as  yet.  Reporting  any  problems, 
questions,  or  comments  to  the  NCC  (via  GRIPE)  would  be  especially  helpful. 


1 TIP  USER'S  GUIDE 


4.  TENEX 
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TENEX  is  a tiine<sliaring  operating  system,  built  around  the  DEC  PDP-10  computer.  A 
time-sharing  operating  system  is  one  that  allows  many  people  to  use  a computer  at  the 
same  time;  to  create  and  run  programs  or  share  other  users’  programs  or  use  standard 
programs  (subsystems)  provided  with  the  system.  While  being  able  to  share  programs  and 
data  the  user  is  also  able  to  beep  information  confidential. 

TENEX  supports  a number  of  subsystems,  each  of  whit'i  does  a particular  Job.  Some 
subsystems  are  highly  self-contained,  and  require  little  knowledge  of  the  rest  of  TENEX; 
others  do  specific  jobs  such  as  editing  or  compilation,  are  typically  used  together  with  other 
subsystems,  and  require  of  the  user  more  complete  knowledge  of  TENEX. 

Information  about  programs  and  subsystems  supported  by  TENEX  can  be  found  in 
directory  <DOCUMENTATION>.  <DOCUMENTATION>  files  are  catalogued  according  to 
type  (c.g.,  .manual,  .Info,  .changes)  and  files  with  a .changes  type  are  generally  In  message 
file  format. 
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4.1  OPERATING  SYSTEM 


The  TENEX  EXECutive  (or  simply,  the  EXEC  or  system)  is  the  operating  system  program 
that  supervises  everything  the  user  runs  on  the  computer.  The  computer  can  run  one 
program  for  each  user  at  a time,  and  the  first  program  run  when  the  machine  Is  started  up 
Is  the  EXEC,  which  also  manages  placement  of  files  on  the  disk,  where  programs  are  In 
core,  reading  and  writing  characters  on  terminals  and  the  line  printer. 

In  Its  simplest  form  the  system  looks  like  this: 
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and  the  basic  definitloas  are: 

OPERATING  SYSTEM 

Usually  refers  to  the  whole  picture  above:  the  terminals,  central  processing  unit, 
core  memory,  and  disk. 

CPU  (CINTRAl  PROCESSING  UNIT) 

The  CPU  follows  the  Instructions  (programs)  given  to  It  by  the  user  — It  runs 
the  program. 

CORE  HE NOR Y 

Core  Memory  Is  where  programs  are  held  while  the  CPU  executes  them.  Data 
from  the  terminals  (characters)  and  from  the  disk  (files)  is  stored  in  core  while  It 
is  being  worked  on.  Core  memory  is  made  of  bits\  S6  bits  make  a tuord\  512 
words  make  a page. 

DISK 

Programs  and  data  are  stored  as  fi/es  on  disk.  Program  files  may  be  brought 
Into  core  to  be  run.  Data  files  may  be  created  and  changed  (by  text  editor 
programs,  for  example);  they  may  be  copied  to  the  terminal,  to  the  line  printer, 
or  duplicated  on  disk. 

The  disk  Is  where  your  work  Is  kept  when  you  are  not  working  on  it.  Each  user 
may  have  many  files  on  the  disk,  and  the  names  of  the  files  are  kept  In  the 
user's  directory. 


4.2  EXECutIve  LANGUAGE 


The  TENEX  EXECutive  Language  allows  the  user  to  access  and  control  the  TENEX 
facilities.  The  language  consists  of:  I)  EXEC  commands  that  are  entered  from  keyboard 
terminals,  typing  ? at  the  TENEX  command  prompt  (•)  causes  the  system  to  display  a list 
of  TENEX  commands  on  the  user's  terminal:  and,  2)  the  name  of  a subsystem.  A subsystem 
Is  a program  which  was  developed  to  enable  users  to  perform  tasks  on  a computer  and  any 
user  may  start  them  by  Just  typing  their  names. 

Communication  with  the  EXEC  takes  the  form  of  a dialogue:  the  user  types  a command, 
the  system  does  what  It  Is  toM,  including  filling  in  parts  of  the  command  It  knows  about, 
and  then  comes  back  for  more  Input  from  the  user.  When  the  EXEC  Is  ready  to  accept  a 
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command  it  types  an  at  sign  (n)  the  user  then  types  a command.  Most  commands  are 
terminated  with  a carriagt  return  (CR). 

Login  messages  (messages  automatically  typeo  on  the  terminal  when  a user  logs  in)  from 
the  <SySTEM>  directory  notify  the  user  whenever  changes  are  made  to  existing  subsystems 
or  programs.  Further,  when  the  EXEC  is  intialised  (a  user  logs  in),  it  saves  the  date  and 
time  of  write  of  the  file  <DOCUMENTATION>SYSTEM.CHANCES,  which  will  be 
compared  against  the  date  and  time  of  write  for  programs  run  out  of  <SUBSYS>. 
<NEWSYS>.  or  <OLDSYS>.  If  the  program  Is  newer,  the  message  "[Modified  programr  i* 
typed.  The  appropriate  .CHANCES  file  in  <I>OCUMENTATION>  should  explain  the 
differences. 


4.2.1  Special  Characters 


In  addition  to  EXEC  commands  and  subsystems,  TENEX  supports  a set  of  special 
characters  — namely,  the  ESCAPE  (or  ALTMODE)  terminal  hey  and  control  characters. 

The  ESCAPE  (or  At INODE)  Character 

The  ESCAPE  (or  ALTMODE)  terminal  key  is  labelled  ESC  (or  ALT)  on  most  terminals  and 
is  located  at  the  upper  left  side  of  the  keyboard.  It  does  two  things:  1)  rect^nizes  and 
extends  a partially  typed  command  or  filename,  and  2)  provides  the  user  with  command 
guide  words  (where  applicable),  and  filename  version  information.  If  the  user’s  partial 
typC'in  of  a command  or  filename  is  not  adequate  for  recognition.the  EXEC  will  output  a 
bell  (the  terminal  will  ding)  indicating  more  user  input  is  necessary.  Thus,  the  user  may 
type  part  of  a file  name  or  command  and  ask  the  EXEC  to  supply  the  rest  by  typing  ESC 
(or  ALT),  which  is  shown  in  the  examples  and  scenarios  as  a dollar  sign  ($). 

Control  Characters 

Control  characters  signal  the  system  to  do  something  immediately.  Control  characters  are 
shown  by  preceding  them  with  an  up  arrow.  e.gM  fC.  tA.  They  are  typed  by  holding  down 
the  control  key  (on  the  left  side  of  the  keyboard)  and  then  typing  the  character.  Thus,  the 
control  key  is  like  a shift  key  except  that  there  is  no  "control  lock"  key. 

The  most  Important  control  characters  are  the  following: 

«A  (CONTROL  A)  • DELETE  CHARACTER 

If  a typing  error  Is  made,  typing  tA  will  cause  TENEX  to  forget  the  last 
character  typed.  Usually  a backslash  (0  will  be  typed  followed  by  the  bad 
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character.  Example:  if  the  user  types  A followed  by  B followed  by  tA  (control 
A)  followed  by  C.  the  system  will  echo  'AB/bC  and  it  will  be  just  as  if  ’AC*  had 
been  typed.  On  some  display  terminals  when  tA  is  typed  the  bad  character 
simply  disappears  from  the  display. 

tC  (CONTROL  C)  - CALL  TENEX  EXEC 

Typing  tC  interrupts  whatever  is  happening  and  returns  control  to  TENEX  for 
a new  command  input.  tC  is  used  to  establish  initial  contact  or  to  start  over 
retyping  a command,  or  to  interrupt  a running  program.  Thus,  if  output  is 
madly  scrolling  off  the  screen,  it  may  be  interrupted  with  tC. 

tF  (CONTROL  F)  - FILE  NAME  FIELD  RECOGNITION 

Typing  TF  causes  recognition  of  a partially  typed  field  of  a file  name  and  is 
useful  when  one  or  more  of  the  fields  has  a long  or  complicated  name.  Both 
ESC  and  TF  may  be  used  in  combination  to  perform  recognition  on  the  parts  of 
a file  name.  When  typed.  TF  does  not  print  on  the  terminal.  If  TF  cannot 
recognise  the  field  the  terminal  *beeps*,  signalling  the  user  to  input  more  of  the 
file  name. 

EXAMPLE: 


Ritst  <doctFUMENTATION>xed.mSANUAL;*(CR) 

Since  TF.  ESC  and  (CR)  are  not  printed  on  the  terminal,  what  the  user  actually  sees  is: 


PI 1st  <docUMENTATION>xed. MANUAL:! 


tR  (CONTROL  R)  > RETYPE  CURRENT  COMMAND  LINE 

Typing  TR  causes  the  the  current  command  line  to  be  retyped.  After  several 
control-A's,  the  line  may  become  unreadable.  TR  will  retype  the  line  with  all 
editing  carried  out  up  to  the  point  where  tR  was  typed. 

tW  (CONTROL  W)  - DELETE  CURRENT  WORD 

Typing  tW  Is  exactly  like  typing  tA  except  instead  of  deleting  the  last 
character  typed  by  the  user,  it  deletes  the  last  word  the  user  typed.  Typing  tW 
causes  TENEX  to  print  a left  arrow  (*■),  indicating  the  word  has  been  deleted. 
The  left  arrow  character  Is  shown  on  a terminal  as  a single  underscore. 

tX  (CONTROL  X)  - DELETE  LINE 


Pairo  34  SmtlM  0.1  4.  TRNF.X 


i. 


ll 


•is 


if 


i. 


r : 

i 

! 

r ! 

i 

r i 

i 


n 


r 


0 


i) 

I " 

1 0 

t 

» 

0 


I c 

■ I 

I ^ 

I s 0 


I li 


Typing  tX  at  any  point  in  a command  will  delete  the  entire  command.  This  Is 
useful  when  the  user  has  made  an  error  that  can  no  longer  be  corrected  with  tA 
or  tW.  When  a tX  is  typed  TENEX  types  tX  to  indicate  that  the  line  has  been 
deleted.  The  DEL  terminal  key  can  also  be  used  to  delete  the  entire  line  typed. 
Typing  the  DEL  key  causes  TENEX  to  print  XXX  to  indicate  the  line  has  been 
deleted  and  returns  the  user  to  EXEC. 

tT  (CONTROL  T)  - Interrupt  For  Status 

Frequently  a user  would  like  to  know  whether  his  program  is  making  progress. 
Typing  tT  causes  TENEX  to  provide  status  information  to  the  user  without 
stopping  or  Interrupting  his  program.  An  example  of  a tT  Interrupt  typeout: 

RUNNING  at  4263  LOAD  AV.  « 14.85,  USED  0:01:46.2  In  3:39:30 


4.S  FILE  SYSTEM 


The  TENEX  file  system  provides  I)  access  to  and  control  over  named  files  which  contain 
data  or  text  or  a program,  and  2)  a means  for  storing  and  retrieving  information.  In  order 
to  bring  an  EXEC  command  to  bear  on  a file,  one  must  identify  the  file  In  question  by 
giving  Its  fUe  designator  (or  file  name).  Basically,  the  parts  of  a file  name  which  are 
Important  Immediately  arc: 

<DIRECTORY>NAME .EXTENSION ;VERSI0N 

The  directory  is  the  general  place  under  which  ail  of  a user’s  files  are  listed.  A directory 
name  Is  usually  the  last  name  oi  the  user  or  the  name  of  the  user’s  group  or  project.  If  the 
directory  name  Is  not  included  as  part  of  the  file  name,  the  system  will  assume  the 
directory  name  of  the  logged  In  user. 


EXAHFLE: 


NANE .EXTENSI0N;VERSI0N 


To  access  files  In  other  directories  the  user  must  name  the  directory  as  part  of  the  file 
name.  In  file  name  specifications,  directory  names  begin  and  end  with  opening  and 
closing  angle  brackets: 


EXAHPLE: 


<0IRECT0RYIIANE>IIANE  .EXTENSION  ;VERSI0N 
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TF.NEX  will  perform  recognition  on  a directory  name  if  a partially  typed  name  Is 
terminated  by  ESC  (or  AITI  or  tF. 
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The  nomr  is  the  next  part  of  the  file  name.  Names  may  be  up  to  any  S9  letter  and  digits. 
The  name  is  frequently  all  that  need  be  typed  to  refer  to  a file.  As  with  directory  names. 
TENEX  will  recognire  file  names  when  they  are  terminated  with  ESC  (or  ALT)  or  tF.  The 
user  has  total  control  over  file  names  in  his  directory  and  can  construct  file  names  that 
require  little  Input  for  recognition. 

The  extension  Is  a way  to  have  several  related  files  with  the  same  file  name.  Frequently  It  is 
desirable  to  create  several  files  with  the  same  file  name,  containing  perhaps  related 
information.  TF.NEX  file  extensions  makes  this  possible  by  allowing  the  user  to  create  the 
extension.  Extensions  consist  of  a period  followed  by  any  combination  of  up  to  S9  letters 
and  digits.  Although  TFNEX  regards  ail  files  as  having  extensions,  the  user  can  specify  a 
null  extension  (one  having  no  characters)  by  typing  just  the  initial  period. 

The  version  numbers  carry  the  idea  of  file  extensions  one  step  further  and  put  it  to  use  for 
a different  purpose.  Version  numbers  allow  the  user  to  create  multiple  disk  files  with  the 
same  combination  of  file  name  and  extension.  The  intent  of  version  numbers  is  to  keep 
track  of  successive,  modified  versions  of  a single  file.  The  system  will  usually  assume  the 
highest  version  number  if  it  is  left  off  (with  certain  desirable  exceptions  noted  in  the  Basic 
Commands  section). 

Examples  of  File  Designators: 

REPORT]. :1 
REPORT!. 

REPORT.RNO;! 

<BLACK>BANANA.;I 

LPT:  (special  designator  meaning  the  line  printer) 

TTY:  (special  designator  meaning  the  terminal) 

XGP:  (special  designator  meaning  the  Xerox  Graphics  Printer) 

The  structure  of  TENEX  file  name  reflects  the  convenience  and  uniformity  of  the  TENEX 
file  system,  most  of  which  would  be  lost  if  the  user  had  to  enter  all  of  the  file  name  each 
time  he/she  accessed  a file. 

Certain  TENEX  commands  can  address  several  files  at  one  time.  For  example,  one  can 
APPEND  a series  of  files  onto  an  existing  file,  or  DELETE  several  files  in  one  operation. 
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4.S.I  Croup  File  Access 


TENEX  provides  a mechaalsm  whereby  users  caa  form  groups  for  the  purpose  of  file 
sharing.  This  is  useful,  for  example,  where  several  users  are  collaborating  on  a comnton 
task  or  project  and  wish  to  share  the  files  they  are  creating.  Each  group  is  assigned  a 
number.  For  each  user.  TENEX  records  a series  of  these  numbers  indicating  what  groups  he 
belongs  to.  Likewise,  for  each  file  directory.  TENEX  records  numbers  Indicating  which 
groups  have  access  to  the  files  it  contains.  Thus  a given  user  can  belong  to  a number  of 
groups.  He  can  make  bis  directory  available  to  one  or  more  groups.  The  assignment  of 
group  numbers  to  users  and  to  file  directories  Is  done  by  the  TENEX  system  operators. 


4.4  EXECtttive  COMMANDS 


TENEX  EXECutive  commands  are  made  up  of  three  components:  keywords,  noise  words,  and 
arguments.  Each  command  begins  with  an  Initial  keyword  that  identifies  its  main 
function:  it  may  contain  further  keywords  that  select  options.  Noise  words  (always  enclosed 
In  parentheses)  make  TENEX  commands  more  understandable  to  the  user,  but  have  no 
effect  on  command  execution.  Arguments,  such  as  user  or  file  names,  tell  what  a command 
Is  to  act  on. 

Example  of  the  three  components  of  a TENEX  command: 


tAPPEND  (FILE  LIST)  CHAP.2;1  (TO) 

(koyword)  (nolaa  word)  (argunank)  (noise  word) 


CHAP.l;! 

(argunank) 


4.4.1  Command  Fields 


Each  keyword  or  argument  that  the  user  must  specify  begins  a fieid.  The  field  runs  up  to 
the  next  keyword  or  argument  or  to  the  end  of  the  command.  Thus,  a TENEX  field 
contains  one  argument  or  one  keyarord.  followed  possibly  by  one  or  more  noise  words.  The 
au/ue  of  a command  fleM  Is  the  particular  choice  of  keyword  or  arguments  that  begin  It. 
Thus.  In  example  abovr 

tAPPENO  (FILE  LIST)  CHAP.E;!  (TO)  CHAP.l ;! 

The  vainca  of  the  three  f kUs  are:  APPEND,  CHAPJtl.  and  CHAP.Itf. 
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4.4.2  Command  Input  and  Recognition 


I 


TF.NF.X  allow*  tkree  *tyles  of  input.  They  can  be  intermixed  freeiy  within  a command 
with  a separate  style  applied.  If  desired,  to  each  field.  Further,  commands  may  be  typed  In 
either  UPPER  or  lower  case,  or  a combination  of  UPPER/lower  case. 

Futt  Input  — The  user  can  type  any  field  in  its  entirety,  speliing  out  fully  the 
keyword  or  argument  and  the  noise  words  (if  any)  with  their  enclosing 
parentheses.  This  style  is  laborious  but  safe  for  a new  user.  (In  the  foliowing 
examples  user  Input  Is  shown  In  italics.) 

9append  (file  list)  part2.;2  (to)  pttrtl.;l(CR)  [Old  Version]  CR 


Abbreviated  Input  — The  user  can  omit  the  noise  words  from  a TENEX 
command  field:  hr  can  shorten  the  keyword  by  typing  in  enough  characters 
(terminated  by  space)  to  make  it  unique  from  other  commands  acceptabie  in 
that  context.  If  the  user  enters  insufficient  characters  for  unique 
iflentification.  TENEX  will  type  ? and  abort  the  command.  This  style  allows 
experienced  nsers  to  type  commands  very  concisely. 

9ap  part2  partRCR)  [Old  Version]  CR 

Recognition  Input  — The  user  can  enter  initial  command  characters  as  above, 
but  terminate  with  ESC  (or  ALT)  instead  of  space.  TENEX  will  type  back  the 
remainder  of  the  command  (or  keyword)  together  with  any  Immediately 
following  noise  words  — i.e.,  everything  through  the  end  of  the  current  field. 
Recognition  input  Is  helpful  to  less  than  fully  experienced  users  because 
TENEX  verified  that  the  intended  command  has  been  given  and  supplies  clues 
to  what  the  user  is  expected  to  type  next.  (User  input  is  shown  in  lowercase 
italics,  ESC  Is  shown  as  $.) 


fnplPEND  (FILE  LIST)  part2t.;2  (TO)  partlt.;l  [Old  Version]  CR 

When  using  ESC  (or  ALT),  insufficient  character  input  causes  TENEX  to 
merely  ring  the  terminal  bell  and  wait  for  more  input. 

With  certain  frequently  used  commands,  fewer  than  the  minimum  characters  are  accepted 
by  convention  In  either  Abbreviated  or  Recognition  input.  An  example  Is  LOG,  which  Is 
taken  to  mean  LOGIN  even  though  LOGOUT  also  begins  with  LOO. 


Fait*  W Sectla* 
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4.4.S  CominaM  TermlMtors 


Space.  ESC  (or  ALT),  and  carriafc  retora.  ihowa  as  (CR).  can  terminate  commanda. 
AHkonifli  (CR>  Is  tlie  standard  TENEX  command  terminator,  there  are  the  following 
exceptions. 


(CR)  rrraifnarrj  last  fMd.  With  most  commands.  TENEX  will  begin  execntlon 
Immediately  If  the  oscr  terminates  the  last  field  with  (CR)  Instead  of  space  or 
ESC 


Confirming  (CR)  netdtd.  Some  commands,  notably  those  that  change  or  destroy 
Information,  always  reqaire  a final  (CRX  even  If  (CR)  ended  the  last  field.  With 
these  commands,  TENEX  reminds  the  nser  that  final  confirmation  Is  needed  by 
typing  (Confirm). 


N6  termtnotor  nteded.  With  certain  liarmicss'  commands,  such  as  queries  about 
the  system,  no  terminator  Is  required;  TENEX  will  take  action  as  soon  as  the 
last  field  Is  entered. 


Subcommands  to  foUow.  Certain  TENEX  commands  can  be  followed  by  optional 
subcommands.  Typing  comma  (.)  before  a terminating  CR  tells  TENEX  that 
subcommands  are  to  follow.  TENEX  types  M and  waits  for  subcommand 
Input.  Typing  I at  M causes  TENEX  to  list  the  available  subcommands. 
When  all  subcommands  have  been  entered,  two  CR  must  be  typed  to  terminate 
Input  of  the  command. 


The  commands  given  below  form  a basic  set  that  will  allow  the  new  user  to  get  started.  A 
list  of  ALL  of  the  commands  supported  by  TENEX  are  available  by  typing  I at  the  TENEX 
command  level  (•)  Typing  f and  using  the  ESC  (or  ALT)  terminal  key  will  help  In 
learning  these  and  other  commands. 


We  will  show  commands  In  both  recognition  and  abbreviated  form.  User  input  Is  shown  In 
lowercase;  system  output  In  UPPERCASE,  or  enclosed  In  square  brackets  ((1)  ESC  (or  ALT) 
is  shown  as  1 CARRIAGE  RETURN  (or  RETURN)  is  shown  as  (CR)  Remember,  typing 
ESC  (or  ALT)  causes  the  system  to  recognise  the  rest  of  the  command  and  to  prompt  the 
user  for  the  next  thing  to  be  typed. 


tIooSIN  (USER)  usernairoS  (PASSWORD)  password!  (ACCOUNT)  account(CR) 
or 

tloo  usernaaie  password  account(CR) 

A user  name  (or  group  name),  a password,  and  a account  name  or  number  are 
necessary  to  use  the  LOGIN  command.  When  the  user  types  his/her  password  it 
does  not  appear  on  the  terminal.  LOGIN  is  the  first  command  that  the  user 
should  type  after  the  host  computer  greeting  line  and  (he  *a(-sign’  (•)  has  been 
output  by  the  system. 

Should  the  user  be  unsure  of  his/her  account  name  or  number,  typing  ESC  (or 
ALT)  after  typing  in  password  space  will  cause  TENEX  to  print  the  account. 
Typing  (CR)  then  terminates  the  LOGIN  command.  TENEX  records  the 
LOGIN  and  prints  login  information  together  with  system  messages  and 
notification  of  new  mail.  If  it  exists,  the  date  and  time  of  the  user’s  last  login 
and  Information  about  other  Jobs  that  may  be  logged  In  under  the  user’s  name. 

EXAHPLE: 


ISI-TCNTX  1.34.7  ISI-SYSTEN-A  EXEC  1.54.3 
9100  smith  1?3456(CR) 

JOB  9 on  TTY9  27-JUL-78  09:09 

PREVIOUS  LOGIN:  26-JUL-78  08:01 

TENEX  WILL  GO  DOWN  THU  7-27-78  2200  TIL  FRI  7-28-78 

0500  FOR  PREVENTIVE  MAINTENANCE 

(YOU  HAVE  NEW  HAIL] 

9 

LOCIN.CMD  File 

Since  many  different  types  of  terminals  are  supported  by  TENEX.  the  terminal  type  should 
be  declared  (and  other  mode  settings,  depending  on  the  terminal  type)  as  soon  as  LOGIN  is 
completed.  One  way  to  set  terminal  parameters  is  to  manually  type  (hem  in  each  time  you 
log  In.  Another  way  Is  to  create  a LOCIN.CMD  file  (using  any  text  editor)  and  have 
TENEX  take  over  the  task  of  setting  terminal  parameters  automatically  by  reading  and 
executing  the  LOCIN.CMD  file  each  time  you  log  in. 

The  commands  in  the  LOCIN.CMD  file  must  appear  exactly  as  you  would  type  them 
directly  to  the  EXEC.  If  any  command  errors  appear  in  the  file,  the  system  will  process  all 
the  commands  up  to  the  one  in  error,  print  a message  telling  the  user  it  found  an  error  and 
abort  the  file.  As  with  any  other  text  file,  the  LOCIN.CMD  file  may  be  edited  to  correct 
errors,  or  to  add  or  delete  commands  as  the  user  desires. 

When  a Job  Is  detached  the  terminal  parameters  are  disabled.  Use  the  REDIRECT 
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command  to  rteoaMe  the  LOCIN.CMD 
•rHirtct  lof  la.ciM(CII)|L 


flogoSUT(Clt) 


tlogo(CII) 


The  LOGOUT  comMand  U OMd  to  alfo  off  froM  the  syataoi.  The  tyata« 
priNta  LOGOUT  InforMatloo.  lacMIof  the  oaoiher  of  jaha  laffod  la  aadcr  the 
aaer*a  aaaie  ahoald  they  ealat.  At  LOGOUT  tiaie.  aialkhecklaf  la  doae.  If 
aiall  exUta.  EXEC  tella  700  aad  aafca  for  LOGOUT  coafinaatloa. 


tlogo(CR) 

TENCX  WILL  GO  DOWN  DAY  DATE  HOUR  TIL  DAY  DATE  HOUR  FOR 
PREVENTIVE  NAINTENANCE 

Ktllad  Job  , USERNANE.  ACCOUNT,  TTY  AT  DATE,  HOUR. 
Used  COMPUTER  TIME  IN  CONNECT  TINE 


fsySSTAT 


fsy(CR) 


A alee  command  that  shows  how  long  the  system  is  ap,  who  Is  on,  and  what 
they  are  doinf.  See  what  yonr  friends  are  op  to.  This  Is  one  of  the  commands 
that  does  not  reqaire  a terminator  if  recognition  (ESC)  is  nsed. 


twhURE  (IS  USER)  directory  naae(CR) 


tidi  directory  naao(CR) 


The  WHERE  command  is  ased  to  obtain  status  of  a single  user  and  tells  you  his 
TTY  number.  JOB  number,  and  if  he  is  at  TENEX  EXEC  or  running  a 
subsystem.  It  also  will  tell  you  his  port  number  if  he  Is  logged  in  from  a TIP 
port  aad  the  directory  name  if  he  Is  connected  to  another  directory. 


fdtSRECTORYfCR) 

or 

»dt(CR) 

fdt  rtlenaMe(CR) 
tdl  f11onaiM,(CR) 
tdl  *.exiens1on(CR) 
fdt  name.KCR) 

Typing  D1$(CR)  or  D1(CR)  thows  on  the  terminal  a list  of  all  the  files  In  the 
user's  directory.  Typing  01  FILENAME(CR)  shows  the  full  name  of  the  single 
file:  Dl  FlI.ENAMEXCR)  shows  the  single  filename  and  puts  the  user  into 
subcommand  mode  (shown  as  Typing  ? lists  the  directory  subcommands 
lliat  are  available,  each  of  which  is  terminated  by  (CR).  Two  (CR)'s  terminate 
subcommand  mode. 

Typing  Dl  •».EXTENSION(CR)  lists  all  of  the  files  In  the  user’s  directory  with 
the  named  extension:  typing  Dl  NAME.t(CR)  lists  all  of  the  files  In  the  user’s 
directory  with  the  name  and  all  of  the  extensions  associated  with  It. 

•qrd(CR) 

or 

tqfd  fllenane(CR) 

fqfd  <dtrectorynane>f tlenaiM(CR) 


This  is  the  Quick  File  Directory  command  that  allows  a user  to  get  full  file 
information  on  all  of  the  files  or  a single  file  in  his  or  another  user’s  directory 
(to  which  he  has  acceu).  i.e..  filename,  versions,  protection,  sise  in  pages,  date  of 
creation,  author,  last  read  date,  last  reader.  This  is  a quick  version  of  the 
DIRECTORY  command  using  the  VERBOSE  subcommand. 

fdeUflE  filenanefCR) 

or 

idol  f ilenaiiie(CR) 

•del  f ilenasw.f i1cnane,filenane(CR) 

Tells  the  system  to  delete  the  named  file  from  disk  and  picks  the  LOWEST 
version  number  if  the  version  number  is  left  off.  The  DELETE  command 
allows  a user  to  delete  several  files  in  one  operation  and  requires  a confirming 
CR.  When  the  user  logs  off  (or  EXPUNCEs)  the  deleted  files  go  away  forever 
(although  there  may  be  back  up  copies  on  tape).  Once  a week  all  files  are 
dumped  on  tape  (this  is  known  as  a FULL  DUMP)i  dally,  newly  created  files  arc 
also  dumped  on  tape  (this  is  known  as  an  INCREMENTAL  DUMP)  and  If  a user 
DELETES  and  EXPUNCES  a file  In  error  It  most  likely  can  be  restored  from 
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rithfr  the  FUl.l.  or  INCREMENTAL  dumps  by  sending  a message  to  the 
ACTION  directory. 
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If  a file  disappears  from  the  user’s  directory,  chances  are  that  the  file  had  not 
been  read  or  written  tor  approximately  a month  and  has  been  ARCHIVED. 
The  nser  should  use  the  INTERROGATE  command  (sec  TENEX  FILE 
ARCHIVAL/RETRIEVAL  SYSTEM  section). 

fundSCLEU  (FILES)  ftlenaiM(CR) 
or 

fund  f tlenanw.f  11onaiM,f11enaiM(Ci() 

Before  the  user  logs  out  or  EXPUNCEs.  one  or  several  deleted  files  may  be 
brought  back  with  the  UNDELETE  command.  Most  useful  (in  addition  to 
mistakes)  It  the  user  wishes  to  delete  all  versions  of  a file  and  then  bring  back 
Just  the  latest  one.  Exampir. 

fdelETE  sieiM).:*(CR)  (•*•  stands  for  "use  everythlno") 
tundELEIE  BieiM.;(CR)  (systasi  picks  latest  version) 

ftySPE  (FILE)  fllenaaw(CR) 
or 

fty  f llenaiae(CR) 

fty  f llenaiM.(CR) 

fty  <d1rectorynasie>f11enasie(CR) 

Types  a file  on  the  terminal.  The  TYPE  command  allows  a user  to  Input 
several  file  names  In  one  operation  and  has  subcommands  available.  Typing  tC 
aborts  output  on  the  terminal  and  returns  the  user  to  TENEX  EXEC 

This  command  will  not  work  for  files  with  an  extension  of  .SAV  or  .REL.  The 
beginning  of  the  file  Is  checked  for  garbage  control  characters.  If  many  are 
found.  EXEC  lets  you  know,  and  asks  for  confirmation. 

fllstS  (FILE)  fllenaiM(CR) 
or 

fllat  ri1onafM,(CR) 

fllat  ri1enaaie,f11ena«e,f11onaiiie(CR) 

fllat  <d1rectorynaiao>f11enaiM(CR) 

Lists  a file,  or  several  files  In  one  operation,  from  the  user’s  directory  or  from 
another  directory  to  which  he  has  access  (or  a combination  of  files  from  own  or 
other  directories)  on  the  Hneprinter.  Typing  LIST  FILENAME/CR)  allows 
acccu  to  the  subcommands  supported  by  the  LIST  command.  Typing  t In 
subcommand  mode  (m)  shows  the  snbeommandst  CR  terminates  each 
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siihcommand  Input  and  t (CRVs  terminate  subcommand  mode.  If  the  version 
number  is  omitted  from  the  filename  the  system  assumes  the  HIGHEST 
version. 

This  command  will  not  work  for  files  with  an  extension  of  .SAV  or  .REL.  The 
beginning  of  the  file  Is  checked  for  garbage  control  characters.  If  many  are 
found.  EXEC  lets  you  know,  and  asks  for  confirmation. 

Rsubsystem  naiae(CR) 
or 

fnsa(CR) 

txed(CR) 

therMes(CR) 

The  user  'calls'  (or  starts)  the  various  subsystems  like  XED.  MSG  or  HERMES  by 
typing  the  subsystem  name  followed  by  carriage  return.  Each  subsystem  has  its 
own  command  level  and  commands.  When  a user  is  running  a subsystem  he  is 
out  of  TF.NEX  EXEC  and  must  use  the  subsystem  commands.  Typing  TC  at 
any  point  during  use  of  a subsystem  causes  an  interrupt  and  the  user  is 
returned  to  TENEX  EXEC.  If  a tC  was  typed  accidentally,  the  user  may  use  the 
CONTINUE  command  to  put  him  back  to  where  he  was  in  the  subsystem 
before  the  tC  was  typed. 

VllnSK  (10)  username(CR) 

This  command  creates  a link  between  the  user’s  terminal  and  the  terminal  of 
the  person  NAMEed  such  that  anything  output  to  either  terminal  also  shows  up 
on  the  other.  Example:  assume  that  Pat  is  working  in  a text  editor  and  Dick 
links  to  her  (by  •!  INK  PAT).  Dick  then  types  on  his  terminal  and  this  typing 
is  shown  on  both  his  and  her’s.  So  far  this  will  have  had  no  effect  on  Pat's 
TECO  work,  and  if  Dick  then  breaks  the  link  Pat  can  go  on  with  no 
interruption  to  the  text  editing.  If  Pat  wants  to  talk  back,  however,  she  may  hit 
tC  to  get  to  the  EXEC,  type  comments  to  Dick  by  starting  each  line  with  a 
semicolon  so  that  the  EXEC  will  ignore  it,  and  then  wCONTInue  the  text  editor 
program  after  the  link  is  broken  by  either  her  or  Dick. 

fbrSEMC  (LINKSKCR) 
or 

tbr(CR) 

Used  by  any  party  to  a link  to  break  the  link  and  return  that  person’s  terminal 
to  normal. 

f ;coMMnt. . . 
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Whilr  In  the  EXEC,  any  line  starting  with  a semicolon  Is  ignored.  This  Is 
Msefnl  when  talking  to  someone  via  a link. 

tamSIL  cSHECK  (FOR  USER)  usernaM(CR) 
or 

fna  c usernaiM(CR) 

The  MAIL  CHECK  command  allows  a logged  in  user  to  check  (directory 
protection  willing)  to  see  If  another  user  has  new  mail.  This  command  is  very 
useful  to  a user  who,  though  not  logged  in,  wishes  to  have  his/her  directory 
checked  for  new  mail 

tACCESS  (OF  FILE  LIST)  <ft1es>  (TO)  <access  path>  (IS)  <access>(CR) 

The  ACCESS  command  allows  a user  to  control  access  to  the  files  in  his 
directory.  <acccss  palh>  is  one  or  more  of  the  following  words  separated  by 
commas:  SELF.  CROUP.  OTHERS.  ALL.  The  default  invoked  by  (ESC)  mode  is 
OTHERS.  • 

<access>  is  one  or  more  of  the  following  words  separated  by  commas:  READ, 
WRITE.  APPEND.  EXECUTE.  PACE-TABLE.  APPEND,  NORMAL.  ALL, 
NONE. 

The  default  U NORMAL,  which  is  the  same  as  READ.EXECUTE.PACE-TABLE. 

I 

Exanplu: 


ACCE  F00.HAC,*.F4:*  6.0  R.ti.AP 


ttcSOPY  (FILES)  fllenaiM(CR) 
or 

ftc  f llonaiiia(CR) 

ttc  f11onaiiM,f11anaiM,f11enana(CR) 

A combination  of  the  TYPE  and  COPY  commands.  It  COPY'S  a file  list  to  the 
TTY:  It  takes  no  subcommands.  This  command  will  not  work  for  files  with  an 
extension  of  .SAV  or  .REL  The  beginning  of  the  file  U checked  for  garbage 
control  characters.  If  many  are  found,  EXEC  lets  you  know,  and  asks  for 
confinnatlon. 
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4.S  FILE  ARCIIIVAL/RETRIEVAL  SYSTEM 


Thr  TENEX  EXEC  supports  a file  archival  facility.  The  purpose  of  the  archival  facility  Is 
twofold: 

1)  It  provides  each  user  with  a large,  long-term  storage  capability. 

2)  It  provides  the  system  with  a mechanism  for  freeing  online  storage. 

User  files  are  allowed  to  "age"  in  the  user’s  directory  for  approximately  SO  days.  Files  so 
"aged",  neither  read  nor  written  for  a month,  will  be  copied  several  times  to  the  magtape 
archive,  verified,  and  deleted  from  the  user’s  directory.  The  location  of  the  file  Is  recorded 
(see  INTERROGATE  below)  so  that  the  user  will  be  able  to  notify  the  operator  of  a 
retrieval  request. 


4.5.1  The  ARCHIVE  Command 


The  ARCHIVE  command  provides  the  user  with  a method  for  setting  archive  requests, 
resetting  archive  requests,  and  determining  If  a file  is  in  the  process  of  being  archived. 

9ARCHIVC  <second  keyword)  (FILE  LIST)  <file  list) 

< second  keyword)  Is  one  of  the  following: 

DFLEIE 

[ XPUNGE 

FIIE 

RESET 

STATUS 

UNDELETE 

DELETE.  UNDELETE  ft  EXPUNGE  give  users  control  over  the  names  In 
their  archived  files  directory  file  JARCHIVE-OIRECTORYt . ;1. 

FILE  will  request  archival  of  the  f11e(s)  In  the  <f11e  list) 

RESET  will  clear  archival  Information  In  the  <f11e  list) 

STATUS  shows  the  archival  status  for  the  <f11e  list) 
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By  typing  ■ comma  after  <file  list>.  one  can  give  lubcommands  to  the  ARCHIVE 
command.  Current  anbcommands  are: 

fPOCFCRREO 


This  tells  the  system  to  archive  <file  list>  at  the  next  time  the  archive  system  Is 
run  (the  defauhV 

R9DELE1E 

This  tells  the  system  to  delete  <file  llst>  from  disk  AFTER  they  have  been 
archived  and  verified  (the  default). 

RRDON'T  ARCHIVE 


This  tells  the  system  to  never  archive  the  specified  file. 
fPOON'T  DELETE 


This  tells  the  system  to  not  delete  the  file  from  the  directory  after  It  has  been 
successfully  copied  to  the  archive. 

As  with  other  EXEC  subcommand  modes,  two  carriage  returns  confirm  the  execution  of  the 
ARCHIVE  command  whenever  subcommands  have  been  specified. 

Example  of  ARCHIVE  command  use: 

ParcHlVE  T ONE  OF  THE  FOLLOWING: 

OLIETE 

EXPUNGE 

FILE 

RESET 

UNDELETE 
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arcHlVE  flLE  (FILE  LIST)  or«ph.apr-78:l. 
f»r  ONE  OF  THE  FOLLOWING: 

Dl  FERREO 
DELETE 
DON'T 
IHHEDIATE 

fPdon't  dELETE 

fP 

9 

•arcHIVE  STATUS  (OF  FILES)  graph. apr-78;* 

GRAPH. APR- 78:1  ARCHIVE  WITHOUT  DELETION  PENDING 

t 


4.%.i  Tht  INTERROGATE  Command 


The  INTERROGATE  command  is  used  on  a fully  archived  file.  Typing 
81N1ERR0GATE  <r  nenaffle>(CR) 

causes  the  archive  to  be  interrogated.  If  the  specified  fiie  is  not  found.  THAT  FILE  IS 
NOT  ARCHIVED  is  typed  out:  if  the  file  is  found.  ARGHIVED  ON  TAPES  MMM  AND 
NNN  is  typed  out;  if  found.  DO  YOU  WANT  IT  RETRIEVED.*  is  also  typed  out;  if  the 
answer  is  yes.  a message  will  be  printed  on  a special  teletype  in  the  computer  room:  the 
operator  will  periodically  check  for  such  requests;  when  the  file  has  been  retrieved,  the 
retrieval  will  be  confirmed  via  SNDMSG. 

As  with  the  ARCHIVE  command,  typing  a comma  after  the  file  name  (or  list)  gives  the 
user  access  to  the  INTERROGATE  subcommands.  Two  carriage  returns  confirm  the 
execution  of  the  INTERROGATE  command  whenever  subcommands  have  been  specified. 
INTERROGATE  subcommands  are  shown  in  the  following  example. 
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ttntCRROGATE  oraph.iaar-78.  ;l 
<SIGNAL>GRAPH.NAR-78.:I  archtvad  on  tapes  3246  and  3241 
do  you  want  It  rotriovodT  (Y  or  N)  yes 
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#tntERR06ATE  graph  .iMr>78 
M7 

ALL .FILES 
Bl FORE. DATE 
DA1ES 

DCLETED.FILES.ONLY 

DOUBLE .SPACE 

EVERYTHING 

INDIVIDUAL 

IPT 

NO. HEADING 

NUMBERS 

OU1 PUT. TO. FILE 

PROTECTION 

REVERSE .ORDER 

SINCE. DATE 

STATUS 

TAPE 

TIMES. AND. DATES 
UNDELETED. FILES.ONLY 
VERBOSE 

CARRIAGE  RETURN  TO  GO 


BfvERBOSE 

»9 


<SIGNAL>GRAPH.HAR-7B;1;P77S200 

3246  l-APR-78  3241  l-APR-78 
do  you  Mant  It  retrlavedT  (Y  or  N)  yes 


4.6  Command  Summary 


In  Ihc  following  summary  of  commonly  used  commands,  parentheses  0 Indicate  prompting 
(or  noise  words),  square  brackets  (J  indicate  optional  Input  by  the  user,  a single  star  • 
Indicates  subcommands  are  available,  and  double  star  ♦♦  Indicates  system  defaults.  Type  ? 
at  • to  see  all  trf  the  commands  avallablet  type  the  command  and  use  ESC  (or  ALT)  and  7 to 
see  what  the  command  does  and  how  It  may  be  helpful  In  using  TENEX. 


Flic  Operations; 

access  (10  FILES)  ftlename  (BY)  access  path  (IS)  accass 
apPlND  (FILE  LIST)  rilenaiM  (TO)  menane 
arcHIVE  second  keyword  (FILE  LIST)  fllenane  * 

COPY  (FILE  LIST)  nicnaMe  (TO)  filename 
dclETE  filename 

dlRTCTORY  <d1rectoryname>f11ename  * 
expUNGE  (DELETED  FILES) 

IntERROGATE  filename  or  ESC  • 

list  (FIIE)  filename  • 

proTECTION  (OF  FILE)  filename  (IS)  octal# 

qfd  filename 

renAHF  (EXISTING  FILE)  filename  (TO  BE)  filename 

tcOPY  (FILES)  filename 

tYPE  (FILE)  filename  * 

undELETE  (FILES)  filename 

perpETUAL  (FILES)  filename 

not  perpETUAL  (FILES)  flleneme 


Editing; 


(«A) 

CIRL-A 

(character  delete) 

(tC) 

CTRL-C 

(abort  and  return  to  Exec) 

(tf) 

CTRL-F 

(field  recognition) 

(»R) 

CTRL-R 

(retype  edited  command) 

(»W) 

C1RL>V 

(delete  current  word) 

(♦X) 

CTRL-X 

(delete  current  line) 

Formatting; 
f ormf  1 1 D 

IndlCATE  (FORMFEED) 
lowfRCASE  •• 
no  formFEEO  •• 
no  lower CASE 
no  raise 
no  tabs 
ralSE  •• 

atoPS  N.  N.  ....  N 
WIDTH  (OF  LINE  IS) 
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brlML  (LINKS) 

IlnK  (10)  tty#  or  usernauM 
rocMVE  (LINKS) 
refUSE  (LINKS) 

MhIRE  (IS  USER)  usoroMM 

Status; 


daYIIHE 

dIscUSE 

dsKslAT 

JohSIAT 

nctlOAO 

runslAT 

sySIAI 

trmSIAT 

usoSIAT 

vorSION 

Mho 

Hlsccl lancous; 

attACII  (USER)  usernamo  (PASSWORD)  password  (JOB  #)  # 

CHANGE  paSSWORD  (OF  DIRECTORY)  nano  (FROH  PASSWORD)  old  password  (PASSWORD) 

new  password  (PASSWORD)  now  password 
connlCT  (TO  DIRECTORY)  dlractorynana  (PASSWORD)  PASSWORD 
conTINUE 
dcLACH 

exec  (or  push) 

logIN  (USER)  usernaiM  (PASSWORD)  password  (ACCOUNT)  account 
logoUT 

malL  chECK  (FOR  USER)  usarnaiaa 
numBLR  (OF  DIRECTORY)  dIractorynaiM 
quit  (or  pop) 
run  (FILE)  fllanana 
taRHINAL  (TYPE  IS)  kind 
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5.  TOPS-20 


Thr  TOrS-20  timesharing  operating  system  is  based  on  the  TENEX  operating  system  with 
some  features  from  the  TOPS-IO  operating  system  and  a few  entirely  new  features.  A time- 
sharing operating  system  is  one  that  allows  many  people  to  use  a computer  at  the  same 
time:  to  create  and  run  programs  or  share  other  users'  programs  or  use  standard  programs 
(subsystems)  provided  with  the  system.  While  being  able  to  share  programs  and  data,  the 
user  is  also  able  to  beep  information  confidential. 

Information  about  the  programs  and  subsystems  supported  by  TOPS-20  can  be  found  in 
directory  <I>OCllMENTATION>.  <DOCUMENTATION>  files  are  catalogued  according  to 
type  (e.g..  .manual,  .info,  .changes)  and  files  with  a .changes  type  are  generally  in  message 
file  format. 

There  Is  a HELP  program  which  gets  help  information  for  some  programs.  Type  HELP 
and  the  name  of  the  program  or  subject,  e.  g.,  type 

PiiELP  HANUALS(RET) 

for  a list  of  and  information  about  TOPS-20  manuals  available  from  The  Digital 
Equipment  Corporation  (DEC). 


5.1  OPERATING  SYSTEM 


The  TOPS-20  operating  system  (also  called  a monitor  or  a supervisor)  supervises  everything  the 
user  runs  on  the  computer.  The  computer  can  run  one  pri^ram  for  each  user  at  a time;  the 
first  program  run  when  the  machine  is  started  up  is  the  operating  system  program,  or 
simply  the  system.  The  system  manages  placement  of  files  on  the  disk,  where  programs  are 
In  core,  reading  and  writing  characters  on  terminals  and  the  line  printer. 

In  its  simplest  form  the  system  looks  like  this: 
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and  the  basic  definltient  are: 


OPERATING  SYSIEN 

Usually  refers  to  the  whole  picture  above:  the  terminals,  central  processing  unit, 
core  memory,  and  disk. 

CPU  (CENTRAL  PROCESSING  UNIT) 

The  CPU  follows  the  Instructions  (programs)  given  to  It  by  the  user  — it  runs 
the  program. 

CORE  HE NOR Y 


Core  Memory  is  where  programs  are  held  while  the  CPU  executes  them.  Data 
from  the  terminals  (characters)  and  from  the  disk  (files)  is  stored  in  core  while  it 
is  being  worked  on.  Core  memory  is  made  of  Ms{  S6  bits  make  a word;  S12 
words  make  a page. 


Programs  and  data  are  stored  as  fUes  on  disk.  Program  files  may  be  brought 
into  core  to  be  run.  Data  files  may  be  created  and  changed  (by  text  editor 
programs,  for  example);  they  may  be  copied  to  the  terminal,  to  the  line  printer, 
or  duplicated  on  disk. 

The  disk  is  where  your  work  is  kept  when  you  are  not  working  on  it.  Each  user 
may  have  many  files  on  the  disk,  and  the  names  of  the  files  are  kept  in  a 
directory  named  after  the  user  or  the  user’s  group. 

Each  directory  has  two  disk  allocations,  both  of  which  are  enforced.  One  is  a 
working  storage,  which  is  the  maximum  amount  of  disk  you  can  use  while  being 
l(*ggm>ln.  The  second  is  permanent  storage,  which  is  the  maximum  disk  space 
the  user  may  have  at  logout  time.  As  the  working  storage  limit  is  exceeded, 
deleted  files  will  be  expunged  automatically  to  allow  for  more  room,  and  the 
user  is  notified  of  each  file  which  is  expunged. 


S.2  COMMAND  LANGUAGE 


The  TOPS-20  Command  Language  allows  the  user  to  access  and  control  the  TOPS-2t 
facilities.  The  language  consists  of:  I)  system  commands  that  are  entered  from  keyboard 
terminals,  typing  I at  the  system  prompt  (■)  prints  a list  of  TOP8-2t  commands,  and;  t)  the 
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name  of  a subsystem.  A subsystem  is  a program  developed  to  enable  users  to  perform  tasks 
on  a computer.  Tke  subsystem  programs  are  kept  in  a special  directory  of  files  on  the  disk, 
any  user  may  start  them  by  just  typing  their  names. 

Login  messages  (messages  automatically  typed  on  the  terminal  when  a user  logs  in)  from 
the  <SYSTFM>  directory  notify  the  user  whenever  changes  are  made  to  existing  subsystems 
or  programs.  Further,  when  the  system  is  intialized  (a  user  logs  in),  it  saves  the  date  and 
lime  of  write  of  the  file  <I>OCUMENTATION>SYSTEM.CHANCES.  which  will  be 
compared  against  the  dale  and  time  of  write  for  programs  run  out  of  <SUBSYS>. 
<NFWSYS>.  or  <OLDSYS>.  If  the  program  is  newer,  the  message  "(Modified  program]" 
typed.  The  appropriate  .CHANCES  file  in  <D0CUMENTAT10N>  should  explain  the 
differences. 

Communication  with  the  system  takes  the  form  of  a dialogue:  the  user  types  a command, 
the  system  does  what  it  is  told,  including  filling  in  parts  of  the  command  it  knows  about, 
then  comes  back  for  more  Input  from  the  user. 

When  the  system  is  ready  to  accept  a command  it  types  an  at  sign  (t»).  Commands  are 
terminated  with  a carriage  return  (RET). 


S.^.l  Special  Characters 


In  addition  to  system  commands  and  subi^ystems.  TOPS-20  supports  a set  of  special 
characters  — namely,  the  ESCAPE  (ES^.1  (or  ALTMODE)  and  DELETE  (DEL)  (or 
miBOUT)  terminal  keys,  and  control  characters. 

The  ESCAPE  Key 

The  ESCAPE  (or  ALTMODE)  terminal  key.  located  at  the  upper  left  side  of  the 
keyboard,  is  labelled  ESC  (or  ALT)  on  most  terminals.  It  does  two  things:  1) 
alerts  TOPS*M  that  a user  wishes  to  communicate  with  the  system,  and  2) 
instructs  the  system  to  try  to  recc^nize  what  has  been  typed  and  to  type  out  the 
rest.  Thus,  the  user  may  type  part  of  a command  or  file  name  and  ask  the 
system  to  supply  the  rest  by  typing  ESC.  If  the  partial  type-in  is  not  unique 
enough  for  recognition,  then  the  system  will  output  a bell  (the  terminal  will 
ding)  telling  the  user  to  type  in  a few  more  characters  and  another  ESC.  ESC  is 
shown  In  examples  and  scenarios  as  1 

The  DEL  Key 

If  a typing  error  is  made  while  Inputting  a system  command  or  a filename. 
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typing  the  DEL  (DELETE  or  RUBOUT)  key  will  cause  the  system  to  "forget* 
the  last  character  typed.  If  the  DEL  key  is  typed,  the  system  will  print  the  bad 
character  followed  by  a backslash  (\),  e.g.,  wlotTXgin.  On  some  display 
terminals  the  system  removes  the  bad  character  from  the  display. 

CONTROL  CHARACTERS 

Control  characters  signal  the  system  to  do  something  immediately  and  are  shown  on  the 
terminal  preceded  by  an  up  arrow  (tK  e.g.,  tC.  They  are  typed  by  holding  down  the  control 
hey  (on  the  left  side  of  the  keyboard)  and  then  typing  the  character.  Thus,  the  control  key 
is  like  a shift  hey  except  that  there  is  no  "control  lock*  key. 

The  most  important  control  characters  are  the  following: 

CTRL/C  («C)  - CALL  TOPS-20  CONHANO  LEVEL 

Typing  CTRL/C  interrupts  whatever  is  happening  and  returns  control  to  the 
system  command  level.  CTRL(C  is  used  to  abort  a command,  or  to  interrupt  a 
running  program. 

CTRL/F  (tF)  - FILE  NAHE  FIELD  RECOGNITION 

Typing  CTRI./F  causes  recognition  of  a partially  typed  field  of  a file  name 
and  is  useful  when  one  or  more  of  the  fields  has  a long  or  complicated  name. 

Roth  ESC  and  CTRL/F  may  be  used  in  combination  to  perform  recognition  on 
the  parts  of  a file  name.  In  the  following  example.  CTRL/F  Is  used  for 
recognition  of  the  directory  name  and  ESC  is  used  for  recognition  on  the  file 
name.  What  the  user  must  type  is  shown  is  lower  case,  system  output  is  shown 
in  UPPER  case:  ESC  is  shown  as  1 typing  the  return  is  shown  as  (RET). 

EXANPLE : 

a 1 1 si  <doc t rUNENTATION>xed .nSANUAL . I ( RET ) 

Since  CTRL/F.  ESC  and  (RET)  are  not  printed  on  the  terminaL  what  the  user  actually  sees 
Is: 

a I 1 St  <docUNENTATION>xad .manual . I 


CTRL/H  (tH)  - REPRINT  PART  OF  CONHANO  LINE 

If  a command  line  containing  an  error  has  been  terminated  (the  RET  key 
typed),  the  system  Informs  the  user  of  the  error  by  printing  a ?.  sometimes 
followed  by  an  error  message.  Typing  CTRL/H  (which  will  echo  on  the 
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terminal)  causes  the  system  to  type  the  command  line  up  to  the  error.  The  user 
may  then  complete  the  command  correctly. 

CTRL/W  (tU)  . DELETE  SINGLE  FIELD 

Typing  CTRt7W  is  exactly  like  typing  DEL.  except  that  instead  of  deleting  the 
last  character  typed  by  the  user,  it  deletes  the  last  word  (or  field)  the  user  typed. 
Typing  CTRL/W  causes  the  system  to  print  a left  arrow  (*-).  indicating  that  the 
word  (or  field)  has  been  deleted.  The  user  is  then  allowed  to  continue  typing  the 
command.  On  some  terminals  the  left  arrow  character  is  printed  as  a single 
underscore:  on  some  display  terminals  the  system  removes  the  word  (or  field) 
from  the  display  instead  of  printing  the  underline  or  backarrow. 

CTRL/U  (tU)  - ERASE  AND  CANCEL  CURRENT  COHHAND 

Typing  CTRL/U  at  any  point  in  a command  will  cancel  the  entire  command 
and  prevent  the  system  from  acting  on  It.  The  system  prints  XXX  before 
printing  the  prompt  character  (■).  On  some  display  terminals  the  system 
simply  removes  the  line  instead  of  printing  XXX. 

CTRL/T  (tT)  - INTERRUPT  FOR  STATUS 

To  find  out  if  a program  is  running,  type  a CTRL/T:  the  system  prints  a status 
message  telling  the  user  the  state  of  the  program,  the  amount  of  system  time 
used  In  the  amount  of  time  the  user  has  been  logged  In  (or  connected  to  the 
system).  Typing  CTRL/T  docs  not  affect  the  program:  It  merely  prints 
Information  about  It. 

EXAMPLE 


RUNNING  at  4263  USED  0:01:46.2  In  3:39:30 
(status)  (CPU  time)  (connect  time) 


CTRL/0  (to)  - SUPPRESS  OUTPUT 

Typing  CTRl/O  suppresses  output  to  a terminal.  The  system  prints  tO...  and 
stops  all  output  to  the  terminal.  The  program  (or  command)  still  executes,  but 
no  output  appears  on  the  terminal.  When  the  program  (or  command)  finishes, 
the  system  prints  the  system  prompt  (•).  Typing  a second  CTRL/O  causes  the 
output  on  the  terminal  to  continue  printing  at  the  point  where  the  program  is 
currently  executing. 

To  control  Information  from  moving  off  the  screen  of  display  terminals,  set  the 
PACE  argument  of  the  TERMINAL  command. 
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CTRL/S  («S)  and  C1RL/Q  (tQ)  - STARTING  and  STOPPING  TERNINAL  OUTPUT 
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Setting  the  TERMINAL  PACE  mode  allows  a user  to  stop  and  start  output  to 
the  terminal  without  interrupting  the  program  (or  command)  producing  the 
output.  With  TERMINAL  PACE  mode  set.  typing  CTRL/S  causes  the  system 
to  stop  the  output  to  the  terminal,  and  typing  CTRL/Q  causes  the  system  to 
resume  typing  the  output  to  the  terminal.  If  the  output  being  typed  is  longer 
than  the  current  page  length  for  the  user’s  terminal,  the  system  automatically 
stops  the  printout  and  rings  the  terminal  bell.  Typing  CTRL/Q  continues 
printing  the  output. 


Use  the  INFORMATION  (ABOUT)  TERMINAL-MODES  command  to  see  the 
current  values  of  your  terminal  parameters  (or  settings).  If  useful,  set  the  page 
length  by  including  It  in  the  TERMINAL  PACE  command.  e.g..  TERMINAL 
PACE  20  (sets  the  terminal  page  length  at  20  lines). 
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The  TOPS-20  file  system  provides  1)  access  to  and  control  over  named  files  which  contain 
data  or  text  or  a program,  and  2)  a means  for  storing  and  retrieving  information.  In  order 
to  bring  an  system  command  to  bear  on  a file,  the  user  must  Identify  the  file  in  question 
by  giving  its  filt  tptclfUatien  (or  file  name).  The  parts  (or  fields)  of  a file  name  which  are 
important  immediately  arr. 

<DIRECTORY>NAHE .TYPE .GENERATION 

The  rlirectery  is  the  general  place  under  which  all  of  a user’s  files  are  listed.  The  directory 
name  in  a file  specification  must  be  typed  enclosed  in  angle  brackets  (o);  the  other  parts  of 
the  file  name  must  be  separated  by  a period  (.).  A directory  name  is  usually  the  last  name 
of  the  user  or  the  name  of  the  user’s  group  or  project.  If  the  directory  name  is  not  included 
as  part  of  the  file  name,  the  system  will  assume  the  directory  name  of  the  logged  in  user. 

To  access  files  in  other  directories  the  user  must  name  the  directory  as  part  of  the  file  name. 
In  file  name  specifications,  directory  names  begin  and  end  with  opening  and  closing  angle 
brackets.  The  system  will  perform  recognition  on  a directory  name  If  a partially  typed 
name  Is  terminated  by  ESC  or  CTRL/F. 

The  name  specifies  a particular  file  in  the  directory.  Names  may  be  any  combination  of  up 
to  $9  letter  and  digits.  The  name  is  frequently  all  that  need  be  typed  to  refer  to  a file.  As 
with  directory  names,  the  system  will  recognise  file  names  when  they  are  terminated  with 
ESC  or  CTRL/F.  The  user  has  total  control  over  file  names  in  bis  directory  and  can 
constmet  file  names  that  require  Httle  Input  for  recognition. 
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Thr  type  spcciflrs  the  content*  of  tlie  file  and  Is  a way  of  having  several  related  files  with 
the  same  name.  Th?  type  part  of  a file  name  consists  of  a period,  followed  by  any 
eomhinatloH  of  up  to  39  letters  and  digits.  Although  the  system  regards  all  files  as  having 
type  MS  part  of  the  file  name,  a user  can  specify  a null  type  (one  having  no  characters)  by 
typing  Just  the  initial  period. 

The  generation  number  specifies  how  many  times  a file  has  been  changed.  Generation 
numbers  allow  the  user  to  create  multiple  dish  files  with  the  same  combination  of  file  name 
and  type.  The  Intent  of  generation  numbers  is  to  keep  track  of  successive,  modified 
versions  of  a single  file.  The  system  will  usually  assume  the  highest  generation  number  If 
It  is  left  off  (with  certain  desirable  exceptions  noted  in  the  Basic  Commands  section). 

Cxanples  of  File  Specifications  (File  nanes): 

NAIL.TXT. 1 
RrPORTl..!,? 

RFPORTl.XGO.l 

<OOCUHEIITATION>XED  .MANUAL . 7 
<DOCUNENTATION>XEO. CHANGES.  1 
<OOCUHENTATION>COMNAND-SUNNARY.INFO.  1 
<HOLG>L0GIN.CN0.7 

LPT:  (special  designator  Meaning  the  line  printer) 

TTY:  (special  designator  meaning  the  terminal) 

XGP:  (special  designator  meaning  the  Xerox  Graphics  Printer) 

The  structure  of  a TOPS*20  file  name  reflects  the  convenience  and  uniformity  of  the  file 
system,  most  of  which  would  be  lost  if  the  user  had  to  enter  all  of  the  file  name  each  time 
he  accessed  a file. 

Certain  system  commands  can  address  several  files  at  one  time.  For  example,  one  can 
APPEND  a series  of  files  onto  an  existing  file,  or  DELETE  several  files  in  one  operation. 


S.S.I  Croup  File  Access 


TOPS-20  provides  a mechanism  whereby  users  can  form  groups  for  the  purpose  of  file 
sharing.  This  is  useful,  for  example,  where  several  users  are  collaborating  on  a common 
task  or  project  and  wish  to  share  the  files  they  are  creating.  Each  group  is  assigned  a 
number.  The  system  records  a series  of  numbers  for  each  u.ver  in  a group,  indicating  what 
groups  he  belongs  tot  for  each  file  directory  the  system  records  numbers  indicating  which 
groups  have  access  to  the  files  H contains.  Thus  a given  user  can  belong  to  a number  of 
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groups.  Ile/ske  can  make  his  directory  available  to  one  or  more  groups.  The  assignment  of 
group  numbers  to  users  and  to  file  directories  is  done  by  the  TOPS-20  system  operators. 


S.4  SYSTEM  COMMANDS 


TOPS-20  system  commands  are  made  up  of  a combination  of  the  following  parts: 

A command  name  identifies  the  command  and  describes  Its  function. 

guide  words  describe  the  kind  of  argument  that  a user  should  type. 

An  argument  is  the  Information  acted  upon  by  the  command. 

switches  and  subcommands  modify  or  specialiu  the  function  of  the  command  in 
which  they  appear. 

A command  terminator  Is  a carriage  return/iinefeed  sequence  (typing  the  Return, 

CR.  or  CAR  RET  hey)  or  a linefeed  (typing  the  LF,  or  LINEFEED  key). 

One-line  commands  arc  terminated  by  typing  the  (RET)  key;  multi-line  commands  (those 
using  subcommands)  are  terminated  by  typing  the  (RET)  key  twice. 

Exanpin  of  one- line  cosmand  terninator: 

fdtrSECTORY  (Of  PILES)(RET) 

<HOLG> 

MAIL. TXT. I 
LOGIN.CMD. 7 

P 

When  subcommands  are  used,  terminate  the  command  line  by  typing  a comma  and  RET. 
The  system  prints  Indicating  that  it  Is  ready  to  accept  subcommands  (typing  ? prints  a 
list  of  the  subcommands).  Each  subcommand  is  terminated  by  typing  (RET);  the  last 
subcommand  Is  terminated  by  typing  the  (RET)  key  twice. 


u 
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Exanpla  of  nultl-llne  conmand  terialnator: 


9d<rlECT0RY  (OF  FILES), (RET) 

99dcUETED  (FILES  ONLY)(RET) 

99(RrT) 

<MOLG> 

IOGIN.CND.6 

TOTAL  OF  1 FILE 
9 

Each  part  of  a command  or  subcommand  (subcommands  contain  names,  guide  words,  and 
arguments  of  their  own)  is  known  as  a field  and  is  separated  from  each  adjacent  field  by  a 
space. 

Example  of  the  APPEND  command  fields: 

PAPPEND  (FILE  LIST)  CHAP.?.l  (TO)  CHAP. 1.1 

(command  name)  (guide  word)  (argument)  (guide  word)  (argument) 

You  already  know  that  typing  ? after  the  command  prompt  (■)  prints  a list  of  the  TOPS-20 
system  commands.  When  unsure  of  a command  or  subcommand  argument,  type  ? to  have 
the  system  print  Information  about  what  It  expects  you  to  type. 


S.4.1  Typing  Commands 


Commands  can  be  typed  using  three  styles  of  input: 

1)  Recognition  Input  - type  a portion  of  the  command  and  press  the  ESC  key. 

2)  Abbreviated  Input  - type  the  unique  portion  of  the  command,  arguments,  and 
subcommands  and  separate  the  fields  with  a space. 

S)  Full  Input  - type  complete  command  names,  arguments  and  subcommands, 
using  a space  to  separate  the  fields. 

The  three  styles  of  command  input  can  be  intermixed  freely  within  a command,  with  a 
separate  style  of  Input  applied,  if  desired,  to  each  field.  Further,  commands  may  be  typed 
In  either  UPPER  or  lower  case,  or  a combination  of  UPPER/lower  case. 
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In  thr  following  examples  of  recognition  and  abbreviated  Input,  what  the  user  types  is 
shown  in  lowercase,  what  the  system  prints  is  shown  in  UPPER  case  or  enclosed  in  square 
brackets  ([)).  ESC  is  shown  as  1*  the  command  terminator  (typing  the  return  key)  is  shown 
as  (RET). 

Example  of  recognition  Input: 

PapSENO  (FILE  LIST)  part?!.. 2 (TO)  partlS..!  [Old  Generation ]( RET) 

4 

1 

Example  of  ebbrevlated  command  Input: 

Pap  part?  partl(RET)  [Old  6enerat1on](RET) 

When  typing  commands,  if  recognition  (typing  ESC  or  CTRL/F)  input  is  used  in  a place 
where  Its  use  is  ambiguous,  the  system  rings  the  terminal  bell.  Type  more  information,  or 
type  ? to  find  out  what  the  system  expects  you  to  type.  With  certain  frequently  used 
commands,  fewer  than  the  minimum  characters  are  accepted  by  convention  In  either 
abbreviated  or  recognition  input.  An  example  is  LOG,  which  is  taken  to  mean  LOGIN  even 
though  LOGOUT  also  begins  with  LOG. 


5.4.2  Basic  Commands 


The  commands  given  below  form  a basic  set  that  will  allow  the  new  user  to  get  started.  A 
list  of  all  of  the  commands  supported  by  TOPS-20  is  available  by  typing  ? at  the  TOPS-20 
command  level  (•).  Use  ESC  and  ? freely  to  learn  these  and  other  commands.  | 

We  will  show  commands  in  both  recognition  and  abbreviated  form.  User  input  is  shown  in 
lower  case;  system  recognition  output  in  UPPERCASE  or  enclosed  in  square  brackets  ([]);  j 

ESC  is  shown  as  $ and  the  command  terminator  typed  by  the  user  is  shown  as  (RET).  j 

Remember,  typing  ESC  causes  the  system  to  recognise  the  rest  of  the  command  and  to  j 

prompt  the  user  for  the  next  thing  to  be  typed.  I 

i 

flogSIN  (USER)  usernames  (PASSWORD)  passwords  (ACCOUNT)  nunber(RET) 
or 

flog  usernaiae  password  account(RET) 

A valid  user  nome.  a password,  and  account  name  or  number  are  necessary  to  use 
the  LOGIN  command. 

User  name  Is  your  name  or  your  group  name  (if  you  are  sharing  a directory)  and  i 

may  consist  ot  up  to  S9  alphanumeric  characters.  Including  hyphen. 

■ 
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Pattword  Is  tlir  password  associated  with  your  user  name:  It  may  consist  of  up 
to  S9  letters  and  digits,  including  hyphen.  Passwords  should  be  hept  secret  and 
known  only  to  those  who  are  using  the  directory.  Passwords  may  be  changed 
using  the  SET  PASSWORD  command.  Passwords  typed  during  the  LOGIN 
command  are  not  printed  on  the  terminal. 

Account  is  your  account  name  or  number.  Typing  ESC  as  your  account  causes 
the  system  to  automatically  print  it. 

After  you  make  a connection  to  your  host  computer  the  system  will  print  a 
greeting  line  and  the  system  prompt  (■).  You  may  then  use  the  LOGIN 
command. 

The  LOGIN  command  validates  you  as  a user,  creates  your  Job.  and  begins 
charging  your  account.  After  creating  your  job.  the  system  executes  the 
commands  stored  in  your  LOGIN.CMD  file.  If  it  exists  In  your  directory. 

EXAMPLE: 


ISl-SYSIEH-E,  TOPS-20  Monitor  101B(1221)-1 
System  shutdown  scheduled  for  27>Ju1-78  22:00:00, 

Up  again  at  28*Ju1-7B  05:00:00 
Olog  smith  123456(RET) 

JOB  9 on  1TY9  27-JUL-7B  09:09 
End  of  LOGIN.CMD. 7 
[YOU  HAVE  NEW  MAIL] 

9 

LOGIN.CMD  File 

A user  may  create  a LOGIN.CMD  file  that  is  read  by  the  system  every  time  he  logs  in. 
Once  a successful  LOGIN  command  is  completed,  the  system  executes  any  TOPS-20 
commands  stored  in  a LOGIN.CMD  file  kept  in  the  user’s  logged-in  directory.  After 
executing  these  commands,  the  system  prints  any  output  from  the  commands  followed  by 
the  message  END  OF  LOGIN.CMD  and  the  system  prompt  (•).  A LOGIN.CMD  file  is  not 
required:  the  user  should  create  the  file  only  if  it's  convenient. 

LOGIN.CMD  files  are  created  using  a text  editor  (XED.  TECO,  etc.).  You  may  enter  any 
system  commands  in  the  LOGIN.CMD  file:  the  system  executes  them  each  time  you  in. 
The  most  common  commands  in  a LOGIN.CMD  file  are  TERMINAL  commands  (to  declare 
the  type  of  terminal  you  have  and  set  appropriate  terminal  modes);  e.g..  TERMINAL  HP. 
TERMINAL  PACE.  TERMINAL  LOWERCASE,  etc. 

If  there  is  an  error  in  one  of  the  commands,  the  system  processes  all  the  commands  up  to 
the  one  In  error,  prints  an  error  message  telling  you  it  found  an  error  and  aborted  the  file. 


Paao  9H  SMliM  LAI 


S.  TOPS-XO 


Miilir  »ure  you  can  give  Ike  commands  exactly  as  you  have  entered  them  Into  the  file.  If 
not.  correct  any  errors  and  try  the  file  again. 

tloooSUI(RET) 

or 

tlogo(RCT) 

The  I.OCOUT  command  expunges  deleted  files  in  your  directory,  deletes  all 
temporary  files  ($T)  created  during  the  session,  checks  disk  storage  allocation, 
ends  your  job  and  prints  a logout  message.  You  may  also  log  out  another  job 
as  long  as  It  Is  logged  in  under  your  user  name. 

EXANPLC: 

tlOCO  (RET) 

Ktlled  Job  99.  User  H0L6,  Account  UDR,  TTY  63.  at  27-Jul-78  09:38:24 
Used  0:0:5  In  0:0:19 

or.  If  loogtno  out  another  Job,  type  the  LOGOUT  connand  and  Job  number 

tlogo  72  (RET) 

9 

You  cannot  log  out  another  user’s  job;  you  cannot  give  a job  number  when  you 
are  logging  out  your  own  job. 

If  you  exceed  your  permanent  disk  storage  allocation,  the  system  prints  a 
message  at  time  of  LOGOUT  telling  you  the  number  of  pages  by  which  you  are 
over  permanent  storage  allocation.  Before  you  log  out,  you  can  find  out  if  you 
are  over  your  allocation  by  using  the  INFORMATION  (ABOUT)  DISK-USAGE, 
or  I I)(RET).  Since  permanent  storage  disk  allocation  is  strictly  enforced,  a 
good  standard  practice  is  to  check  your  status  before  you  log  out.  If  you  are 
running  low  on  space  you  can  delete  unnecessary  files  at  that  time. 

After  logout  the  terminal  will  not  respond  until  you  make  a connection  to  your 
host  computer. 

»sySSTAT(RET) 

or 

fsy(RET) 

Prints  the  header  and  the  job  number,  line  number,  current  program  name  and 
user  name  for  each  job. 

9sy  usornaaw(RET) 
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Prints  Information  about  only  tbc  specified  user. 

tsy  Job  nunber(RET) 
tsy  .(RE?) 

Sy  Job  number(RET)  prints  information  about  only  the  specified  Job.  Sy 
.(RET)  prints  information  about  your  current  Job. 

tsy  all(RET) 

Prints  the  header  and  Job  number,  line  number,  current  program  name,  state  of 
the  Job.  the  accumulated  run  time,  the  run  time  limit,  the  user  name,  and 
connected  directory  for  each  Job. 
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The  SYSTAT  command  prints  information  about  the  current  state  of  the 
system.  The  SYSTAT  command  does  not  change  any  program  in  memory  and 
leaves  your  terminal  at  TOPS-20  command  level. 

tdtrSRECTORY  (OF  FILES)(RET) 
or 

fdlr(RET) 

Prints  the  file  name.  type,  and  generation  number  for  each  file  in  the  user’s 
directory. 

tdtr  f llenaffle(RET) 

Prints  the  file  name,  type,  and  generation  numbers  for  the  file  specified  in  the 
command. 

tdtr  ft1oname,(RE1) 

Typing  comma  (.)  allows  use  of  the  subcommands  associated  with  the 
f>IR ECTOR Y command.  The  system  prints  (indicating  subcommand 
mode);  typing  ? RET  prints  a list  of  the  subcommands.  Each  subcommand 
must  be  terminated  by  RET;  the  last  subcommand  must  be  terminated  by  two 
RET’s. 

tdtr  •.type(RET) 

Prints  all  of  the  file  names  with  the  type  specified  in  the  command, 
tdtr  name.KRET) 

Prints  all  of  the  files  with  the  name  specified  in  the  command. 
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Thr  DIRECTORY  command  prints  information  about  a file  or  group  of  files.  The  system 
lists  the  files  in  alphabetical  order,  unless  the  REVERSE  or  CHRONOLOGICAL 
subcommands  have  been  given.  If  two  files  have  the  same  file  name,  only  the  type  and 
generation  number  for  each  succeeding  file  after  the  first  are  printed.  The  period  before 
the  type  Is  Indented  three  spaces,  if  a file  Is  temporary,  a i*  printed  after  the  generation 
number. 

The  DIRECTORY  command  docs  not  change  any  program  In  memory  and  leaves  the 
terminal  at  TOPS>20  command  level 

ffdlrSCCTORY(RET) 

or 

trdlr(RET) 

•fdfr  f11enaiae(s)(REI) 

KDIR ECTOR Y (or  Full  DIRECTORY)  automatically  prints  everything  about 
the  files  (or  file  names  specified  in  the  command),  without  any  headings,  and 
rompresses  the  output.  It  is  the  same  as  giving  the  DIRECTORY  command 
with  the  CRAM  (output),  EVERYTHING,  and  NO  HEADING  subcommands. 

•td1r$EC10RY(RET) 

or 

ftdlr(RFT) 

tidir  f 1 lename(s)(RE1 ) 

TDIR  ECTOR Y (or  Time-ordered  DIRECTORY)  orders  the  files  (or  files 
specified  in  the  command)  with  the  most  recent  write  dates  first  and  prints  the 
write  times  and  dales.  It  is  the  same  as  giving  the  DIRECTORY  command 
with  the  CHRONOLOGICAL  (BY)  WRITE.  REVERSE  (SORTING)  and  TIMES 
(AND  DATES  OF)  WRITE  subcommands. 

fvdlrSrCTORY(RET) 

or 

fvdlr(RET) 

fvdir  f 11onaiiie(s)(RET) 

VDIRECTORY  (for  Verbose  DIRECTORY)  automatically  prints  the  protection, 
sire,  length,  and  write  time  and  date  for  each  file  (or  filename(s)  specified  in  the 
command).  No  headings  are  printed.  It  is  the  same  as  giving  the  DIRECTORY 
command  with  the  PROTECTION.  SIZE.  LENGTH  (IN  BYTES),  TIMES  (AND 
DATES  OF)  WRITE,  and  NO  HEADING  subcommands. 

By  giving  the  proper  file  specificatlon(s).  you  can  obtain  Information  about  a single  file,  a 
group  of  files,  or  Hies  In  another  directory. 
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•deUETE  (FILES)  ri1ename(s)(RET) 
or 

tdol  f t1cnaiiie(s)(RET) 

Tlic  DELETE  command  Identifies  a disk  file(s)  for  eventual  deletion.  If  a 
generation  number  is  not  specified,  the  system  assumes  the  oldest  number. 

Once  you  delete  a file,  it  is  kept  on  disk  storage  until  either  you  (or  the 
operator)  give  an  EXPUNGE  command,  or  until  you  log  off  the  system.  If  you 
want  to  see  what  files  you  have  deleted,  but  not  expunged,  use  the  DIRECTORY 
command  with  the  DELETED  subcommand.  Once  you  delete  a file,  you  cannot 
access  the  file  with  a normal  TOPS-20  command  or  pit^ram,  except  with  an 
UNDELETE  command,  a DIRECTORY  command  (with  the  DELETED 
subcommand),  or  an  EXPUNGE  command. 

As  the  system  starts  to  delete  a file.  It  prints  the  file  name  and  leaves  a space. 

When  the  file  is  deleted,  the  system  prints  the  success  message  [OK]. 

The  DELETE  command  does  not  change  any  program  in  memory  and  leaves 
the  terminal  at  TOPS-20  command  level. 

If  a file  disappears  from  the  user's  directory,  chances  are  that  the  file  had  not  been  read  or 
written  for  approximately  a month  and  has  been  ARCHIVED.  The  user  should  use  the 
INTERROGATE  command  (see  FILE  ARCHIVAL/RETRIEVAL  SYSTEM  section). 

•undSELETE  (FILES)  rt1enaiM(s)(RET) 
or 

fund  f t1ename(s)(RET) 
fund  name.*(RE1) 

The  UNDELETE  command  restores  previously  DELETEd  disk  files  to  their 
normal  status.  If  a generation  number  is  not  specified  in  the  command,  the 
oldest  number  is  assumed.  If  any  one  of  the  files  you  are  trying  to  undelete 
does  not  exist,  the  system  ignores  the  entire  command  and  prints  an  error 
message  (e.g.,  ?Fllc  not  found).  The  UNDELETE  command  prints  no  error 
message  when  it  cannot  restore  a set  of  files  that  have  been  specified  with  the 
wildcard  (asterisk  as  part  of  the  file  name)  construction.  Files  that  have  been 
EXPUNGEd  cannot  be  undeleted.  If  your  attempt  to  UNDELETE  a file  fails, 
send  a message  to  ACTION  asking  that  the  fiie  be  restored  from  system  backup 
tapes. 

If  MAIL.TXT  is  deleted,  its  contents  are  immediately  expunged.  Using  the 
UNDELETE  command  to  restore  MAILTXT  will  restore  the  filename  but  none 
of  its  contents. 
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Thr  UNDELETE  command  does  not  change  a program  in  memory  and  leaves 
the  terminal  at  TOPS-26  command  level. 

ttypcS  (FILF)  fl1ename(s)(RET) 

The  TYPE  command  prints  the  contents  of  a single  file  name  or  a string  of 
flic  names  (separated  by  commas)  on  your  terminal.  If  you  want  to  stop  the 
printing  of  a file,  type  a CTRL/O  or  two  CTRL/Cs.  If  your  file  has  line 
numbers,  the  system  prints  them  on  your  terminal.  If  you  type  more  than  one 
file  with  a single  TYPE  command,  the  system  prints  the  proper  file  name 
followed  by  a blank  line,  before  it  prints  the  file. 

The  TYPE  command  does  not  change  any  program  in  memory  and  leaves  the 
terminal  at  TOPS-20  command  level. 

fprint  (riirs)/SVITCIIES  f t1ename(s)/swttches(RET) 

Thr  PRINT  command  places  entries  into  the  lineprinter  output  queue,  which  is 
a list  of  Jobs  waiting  to  be  printed.  To  look  at  the  contents  of  the  entire  queue, 
use  the  INFORMATION  (ABOUT)  OUTPUT-REQUESTS  command.  If  you 
want  only  the  entries  for  your  Job(s).  include  the  /USER  switch.  To  just  print  a 
file,  no  switches  are  necessary. 

A swiUA  modifies  or  specialises  the  function  of  the  command  in  which  it 
appears.  If  you  want  a file  switch  to  apply  to  one  file  only,  place  the  switch 
after  the  particular  file  name;  if  you  want  the  file  switch  to  apply  to  all  files  In 
thr  list,  place  thr  switch  before  the  list  of  file  names.  Switches  requiring  a date 
and/or  time  argument:  separate  the  hours  from  minutes  by  typing  a colon  (:), 
and  the  month,  day,  year  by  typing  a hyphen  (•),  e.g.,  9:S0.  JuM-77. 

Some  twitches  are: 

/AFTER:  date  and/or  time  submits  the  file  for  printing  after  the  specified 
dale  or  time. 

/LOWERCASE  - directs  the  printing  job  to  a lineprinter  that  uses  both  upper 
and  lower  case  characters. 

/UPPERCASE  - directs  the  printing  job  to  a lineprinter  that  uses  only 
uppercase  characters. 

/COPIES:n  ~ specifies  that  n copies  of  the  file  be  printed,  n (the  number  of 
copies)  must  be  less  than  SIS.  Normally,  the  PRINT  command  makes  one  copy 
of  each  file. 
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/DELETE  ~ immediately  removes  the  file  from  your  directory  and  deletes  it 
after  it  has  been  printed. 

/SPACINC»ingie  - specifies  no  extra  space  between  lines  on  a printout. 

/SPACINCMlottble  *■  specifies  a single  line  of  spacing  between  lines  on  a 
printout. 

/SPACINCttriple  ~ specifies  a double  line  of  spacing  between  lines  on  a 
printout. 

Typing  /?  prints  a list  of  all  PRINT  command  switches. 

The  PRINT  command  does  not  affect  memory;  It  leaves  the  terminal  at  TOPS- 
20  command  level. 

OtSNrORHATION  (ABOUT)  parameter 
or 

fl  parameter 

The  INFORMATION  command  prints  information  about  various  system  and 
job  parameters.  Type  ? for  a list  of  system  and  Job  parameters  available  with 
this  command.  1'ype  (or  use  recognition  on)  the  parameter  name.  If  the 
parameter  has  a modifier,  type  (or  use  recognition  on)  the  modifier,  press  the 
R F.T  hey  and  the  system  prints  the  Information.  You  may  default  the  modifier 
by  simply  omitting  It. 

EXAHPLfS 

BtNIORHATlON  (ABOUT)  7 One  of  the  foTTowIng: 

AVAIIABLE 

CARD-RE AOER-INPUT 'SET 

COHHAND-LEVEL 

DISK-USAGE 

Fit E -STATUS 

JOB-STATUS 

LOGICAL-NAHES 

HAIL 

HI  HORY-USAGE 
HONIIOR-STATISTICS 
MEIWORK-STATUS 
PROGRAH-STATUS 
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PSI-S1ATUS 

SPOOirO-OUIPUT'ACTION 

SUBSYS1EH-STATIST1CS 

SYSUN-STATUS 

TAPE -PARAMETERS 

TERMINAL -MODE 

VERSION 


• i J 

Job  47,  User  HOLG,  Account  UOR,  TTY162 

• 

tsetS  erouinentsiRET) 
or 

#sot  f One  of  the  following: 

ACCOUNT 

CARD-RE  ADER- INPUT -SET 

CON1ROL-C-CAPABILITY 

ENTRY-VECTOR 

ERROR-RETRY 

FILE 

LATE -CLEAR-TYPE AHEAD 
MAIL -HATCH 
NO 

PASSWORD 
SPOOl ED-OUTPUT 
TAPE 

TIME-LIMIT 

UUO-SIMULATION 

The  SET  command  sets  tke  value  of  various  Job  parameters.  The 
INFORMATION  command  prints  the  values  of  many  of  the  parameters  you 
can  set  with  the  SET  command.  The  TERMINAL  command  sets  various 
terminal  parameters  which  you  can  examine  with  the  INFORMATION 
(ABOUT)  TERMINAL-MODE  command. 

Type  SET  and  leave  a space;  type  (or  use  recognition  on)  the  rest  of  the 
arguments  to  the  SET  command,  then  press  the  RET  key. 

The  SET  command  does  not  change  a program  In  memory  and  leaves  your 
terminal  at  TOFS-2t  command  level 
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ttcrNINAL  <HODE  IS)  T One  of  the  folloMing: 
33 
35 
37 
DM 

EXECUPORT 

FlAG 

FORMFEED 
FULLDUPLEX 
HAIF DUPLEX 
HFIP 
HP 

IMMEDIATE 

INDICATE 

LA30 

LA36 

LENGTH 

I INC -HALFDUPLEX 

LOWERCASE 

NO 

PAGE 

RAISE 

SPEED 

TARS 

TERMINET 

TI 

TYPE 

VT05 

VT50 

VT5? 

WIDTH 


tterMINAL  <NODE  IS)  hp 

f 


The  TERMINAL  command  changes  various  terminal  parameters  such  as: 
Inpot/output  speed,  handling  of  lowercase  characters,  length  and  width  of  the 
terminal  page,  and  handling  of  the  RUBOUT  key. 


The  TERMINAL  command  helps  make  typing  on  the  terminal  more 
convenient.  You  can  print  the  current  values  of  your  terminal  parameters  by 
giving  the  INFORMATION  (ABOUT)  TERMINAL-MODE  command.  If  you 
use  TERMINAL  commands  often,  place  the  command  In  your  LOClN.CMD 
file. 
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Thp  TERMINAL  command  does  not  change  any  program  In  memory  and  leaves 
the  terminal  at  TOPS>20  command  level. 

fsubsysten  naaw(l(CT) 

or  ! 

»«sg<RE1)  I 

txed(ltET)  I 

fherncs(RET)  I 

The  user  ‘calls'  (or  starts)  the  various  subsystems  like  XED,  MSG  or  HERMES  by 
typing  the  subsystem  name  foliowed  by  RET.  Each  subsystem  has  its  own 
command  levei  and  commands.  When  a user  is  running  a subsystem  he  is  out 
of  TOPS-20  command  level  and  must  use  the  subsystem  commands.  Typing 
CTRL/C  at  any  point  during  use  of  a subsystem  causes  an  Interrupt  and  the 
user  Is  returned  to  TOPS-20  command  level.  If  a CTRL/C  was  typed 
accidentally,  the  user  may  use  the  CONTINUE  command  to  put  him  back  to 
where  he  was  in  the  subsystem  before  the  tC  was  typed. 

»conkSINUE(RET) 

The  CONTINUE  command  restores  execution  of  a program  that  was 
interrupted  by  CTRL/C  The  program  is  not  changed  by  the  CTRL/C- 
CONTINUE  process  as  long  as  you  do  not  change  the  contents  of  memory  (e.g.. 
load  another  program)  or  the  files  it  manipulates. 

1 

You  may  stop  a program  by  typing  one  or  more  CTRL/Cs,  give  a PUSH 
command  (to  create  a new  command  level),  run  another  program,  give  a POP 
command  (POP  terminates  the  current  command  level  and  returns  you  to  the 
next  higher  level),  then  give  a CONTINUE  command  to  continue  the  Initial 
program. 

The  CONTINUE  command  continues  the  program  In  memory  and  leaves  your 
terminal  under  Its  control. 

Some  non-standard  programs  may  not  allow  you  to  CONTINUE  them  once  they 
are  interrupted. 

f talks  (TO)  user  name  or  a line  number 

The  TALK  command  creates  a link  between  the  user’s  terminal  and  the 
terminal  of  the  user  or  line  number  specified  In  the  command.  Whatever  you 
type  is  printed  on  both  your  terminal  and  the  linked  terminal;  whatever  a user 
types  on  the  linked  terminal  appears  both  on  his  terminal  and  your  terminal. 

The  linkage  affects  only  the  output  of  the  terminals;  the  input  of  the  terminals 
Is  left  Intact.  c.g„  If  your  program  Is  waiting  for  a command  and  a user  types  a 
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comniand  on  the  linked  tcrmlnak  that  command  works  only  for  his  Job.  not 
yoors  - you  see  only  the  resulting  typescript. 


1. 


To  avoit  getting  the  lUNRECOCNIZED  COMMAND  error  message,  precede 
your  comments  with  an  L 

The  BREAK  command  breaks  any  links  you  have  established  with  the  TALK 
command. 

You  may  not  link  to  a detached  job.  The  TALK  command  does  not  print  a 
password  onto  any  linked  terminals.  If.  however,  you  type  a CTRL/R  while 
giving  a command  containing  a password,  the  password  is  printed. 

The  TALK  command  does  not  change  any  program  in  memory  and  leaves  your 
terminal  at  TOPS-20  command  level. 

fbreSAK  (LINKS)(RET) 
or 

•bro(RET) 

The  BREAK  command  clears  all  links  that  have  been  made  to  or  from  your 
terminal;  the  TALK  command  creates  only  one  link.  BREAK  does  not  require 
you  to  be  logged  into  the  system,  gives  no  error  messages  if  you  do  not  have  any 
links  to  or  from  your  terminal,  does  not  change  a program  in  memory,  and 
leaves  your  terminal  at  TOPS-20  command  level. 


S.S  FILE  ARCHIVAL/RETRIEVAL  SYSTEM 


The  TOPS-20  EXEC  supports  a file  archival  facility.  The  purpose  of  the  archival  facility 
is  twofold: 

1)  It  provides  each  user  with  a large.  long>term  storage  capability. 

2)  It  provides  the  system  with  a mechanism  for  freeing  online  storage. 

User  files  are  allowed  to  'age*  in  the  user's  directory  for  approximately  SO  days.  Files  so 
"aged",  neither  read  nor  written  for  a month,  will  ht  copied  several  times'  to  the  magtape 
archive,  verified,  and  deleted  from  the  user's  directory.  The  location  of  the  file  is  recorded 
(see  INTERROGATE  below)  so  that  the  user  will  be  able  to  notify  the  operator  of  a 
retrieval  request. 

The  following  commands  arc  available  In  the  EXEC  to  support  user  use  of  the  archive. 
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S.S.I  THE  ARCHIVE  COMMAND 


The  ARCHIVE  command  provides  the  user  with  a method  for  setting  archive  requests, 
resetting  archive  requests,  and  determining  if  a file  is  in  the  process  of  being  archived. 

•ARCHIVE  <second  keyword>  (FILE  LIST)  <f11e  11st> 

<socond  keyword>  Is  one  of  the  following: 

DILE1E 

EXPUNGE 

FILE 

RESET 

STATUS 

UNDELETE 

DELETE,  UNDELETE  & EXPUNGE  give  users  control  over  the  names  In 
their  archived  files  directory  file  ]ARCHIVE-DIRECTORY[ . ; 1 . 
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FILE  will  request  archival  of  the  f11e(s)  In  the  <f11e  11st> 

RESET  will  clear  archival  Information  In  the  <f11e  11st> 

STATUS  shows  the  archival  status  for  the  <f11e  11st> 

By  typing  a comma  after  <file  iist>.  one  can  give  subcommands  to  the  ARCHIVE 
command.  Current  subcommands  arr. 

••DEFERRED 

This  tells  the  system  to  archive  <f ile  list>  at  the  next  time  the  archive  system  is 
run  (the  default). 

••DELETE 


This  tells  the  system  to  delete  <file  llst>  from  disk  AFTER  they  have  been 
archived  and  verified  (the  default). 

••DON'T  ARCHIVE 

This  tells  the  system  to  never  archive  the  specified  file. 
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This  tells  the  system  to  not  delete  the  file  from  the  directory  after  It  has  been 
successfully  copied  to  the  archive. 

As  with  other  EXEC  subcommand  modes,  two  carriage  returns  confirm  the  execution  of  the 
ARCHIVE  command  whenever  subcommands  have  l^n  specified. 

Example  of  ARCHIVE  command  use: 

farcHIVE  T ONE  OF  THE  FOLLOWING: 

DELETE 

EXPUNGE 

FILE 

RESET 

UNDELETE 

arcHlVE  FILE  (FILE  LIST)  graph. apr-78;l, 

#97  ONE  OF  THE  FOLLOWING: 

DEFERRED 

DELETE 

DON'T 

IHHEDIATE 

«#don't  dELETE 

#9 

9 

9arcHIVE  STATUS  (OF  FILES)  oraph.apr-78:* 

GRAPH. APR- 78:1  ARCHIVE  WITHOUT  DELETION  PENDING 

9 


S.S.2  THE  INTERROGATE  COMMAND 

The  INTERROGATE  command  Is  used  on  a fully  archived  file.  Typing 
9INTERR06ATE  CfllenaneXRET) 

causes  the  archive  to  be  Interrogated.  If  the  specified  file  Is  not  found.  THAT  FILE  IS 
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N(»T  ARCHIVED  is  lyped  out;  If  the  file  is  found,  ARCHIVED  ON  TAPES  MMM  AND 
NNN  is  typed  out:  if  found.  DO  YOU  WANT  IT  RETRIEVED?  is  also  typed  out;  if  the 
answer  is  yes,  a message  will  be  printed  on  a special  teletype  in  the  computer  room;  the 
operator  will  periodically  check  for  such  requests;  when  the  file  has  been  retrieved,  the 
retrieval  will  be  confirmed  via  SNDMSC. 

As  with  the  ARCHIVE  command,  typing  a comma  after  the  file  name  (or  list)  gives  the 
user  access  to  the  INTERROGATE  subcommands.  Two  carriage  returns  confirm  the 
execution  of  the  INTERROGATE  command  whenever  subcommands  have  been  specified. 
INTERROGATE  subcommands  are  shown  in  the  following  example. 


PintCRROGATE  graph.Mar-78. ;1 
<SIGNAL>GRAPH.NAR-78.:1  archived  on  tapes  3246  and  3241 
do  you  want  It  retrieved?  (Y  or  N)  yes 

8 


or 


RInURROGATE  graph .nar- 78. :1, 
88? 

All  .FILES 

RIIORE.DA1E 

DATES 

DFIETED.FIIES.ONLY 

DOUBLE. SPACE 

EVERYTHING 

INDIVIDUAL 

LPT 

NO. HEADING 
NUNBERS 
OUTPUT. 10. FILE 
PROTECTION 
Rl VERSE .ORDER 
SINCE. DATE 
STATUS 
TAPE 

TINES. AND. DATES 
UNDELETED. FILES.ONLY 
Vt  RBOSE 

CARRIAGE  RETURN  TO  60 
ffvERDOSE 
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FUWC110W  TENEX  TOPS20 


Delete  character 
Delete  line 
Delete  field 
Reprint  line 
Free/e  typeout 
Resume  typeout 
File  names 
Fast  directory 
Status  of  system 
Status  of  disk 
Status  of  flies 
Status  of  Job 
Call  Inferior  EXEC 
Dismiss  Inferior  EXEC 
List  file 
Typo  file 

Change  Job  account 
Assign  file  account 
Change  password 
File  protection 
Upper /lower  case 
Terminal  linking 
Comment 
User  number 
Where  Is  user 


tA 

DEL  key 

tW 

tR 

See  Note  1 
See  Note  2 
name. ext ;vers1on 
QFD 

WHO  or  SYSTAT 

DSKSTAT 

FILSTAT 

JOBSTAT 

EXEC 

QUIT 

LIST 

TCOPY 

CHANGE  ACCOUNT 
ACCOUNT 

CHANGE  PASSWORD 
PROTECTION 
NO  RAISE 
LINK 

f 

NUNBER  (or  NUN) 


DEL  key 

tU 

tW 

tR 

tS 

♦Q 

name .typ .generation 

FOIRECTORY 

SYSTAT 

INFO  DISK 

INFO  FILE 

INFO  JOB 

PUSH 

POP 

LIST 

TYPE 

SET  ACCOUNT 

SET  FILE  ACCOUNT 

SET  PASSWORD 

SET  FILE  PROTECTION 

TER  NO  RAISE 

TALK 

f 

TRANSL 

SYSTAT  username 


WHERE  (Is)  username 


Note  1:  Any  control  character  user  selects  with  FREEZE  command. 


Note  2:  Any  character,  e.g..  space. 
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6.  SNDMSG 


SNDMSG  is  usrd  to  srnd  mrssofes  to  users  throughout  the  ARPANET.  It  prompts  for  the 
addresses  to  which  to  send  the  message,  then  for  the  subject  and  text  of  the  message.  It 
aufoiiiaticaliy  fills  In  the  date  and  and  sender.  Finally  It  sends  the  message.  If  the  message 
can't  hr  delivered  immediately.  It  is  queued  and  automatically  sent  later  by  the  background 
MAILER  process. 

SNDMSG  has  four  fields:  To:.  Cc^  Subject:,  and  Message:.  The  following  sections  describe 
each  of  these  fields  and  the  form  of  the  message  that  Is  actually  sent. 


6.1  THE  ADDRESSES 


Addresses  are  divided  into  To"  and  "cc".  SNDMSG  prompts  separately  for  each.  When 
SNDMSG  prompts  for  addresses,  enter  them  separated  by  commas.  Carriage  return 
teriiiinates  the  list  and  goes  on  to  the  next  section  unless  it  is  preceded  by  a comma,  in 
whirh  case  address  input  continues  on  the  next  line.  There  must  be  at  least  one  To" 
address,  but  there  need  not  be  any  "cc".  If  you  don’t  enter  any  To"  addresses,  SNDMSG  will 
skip  to  the  subject  and  message  fields,  then  will  come  back  to  the  To"  field. 

The  following  kinds  of  items  may  appear  in  the  address  list  separated  by  commas.  (Angle 
brackets  (<>)  are  not  typed  *—  they  are  just  used  in  this  description  to  enclose  a type  of 
item.) 

<user  name> 


The  mail  is  addressed  to  that  user  at  the  default  host.  Normally  the  default  host 
is  the  local  host  (i.e..  the  one  on  which  you  are  running  SNDMSG)  but  you  can 
change  it  as  desired. 

t<host  name  or  octal  host  number> 


Changes  the  default  host  to  be  the  given  host.  The  default  remains  in  effect  for 
the  rest  of  the  address  fist  until  explicitly  changed.  To  set  the  default  back  to 
local,  type  just  ”•*  (i.e.,  emit  the  host  name). 

<user  naaw>f<host  nano  or  octal  host  nunbor> 
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6.  SNDMSG 


Thr  mall  Is  addressed  to  the  given  user  at  the  given  host.  Putting  the  host 
name  together  with  the  user  name  makes  it  apply  only  to  that  user.  That  Is.  it 
does  not  change  the  default  host,  but  overrides  it  Just  for  the  user.  A blank  host 
name  means  the  local  host 

<Group  Nano>: 


All  subsequent  addresses  will  be  considered  part  of  the  specified  group  (which 
can  be  any  name  you  care  to  define).  This  group  remains  in  effect  until 
explicitly  changed  by  another  '‘<group  name):"  item.  Typing  Just  V with  no 
name  In  front  sets  the  group  to  none,  i.e.,  subsequent  addresses  are  ungrouped. 
Group  names  do  not  affect  the  tending  of  the  message  (since  they  are  not 
addresses),  only  what  appears  in  the  heading  of  the  transmitted  message. 

Note:  It  Is  not  necessary  to  separate  the  group  name  from  the  next  address  by  a 
comma:  the  colon  implies  a comma. 

•<Ftlo  nan«> 


The  message  will  be  sent  to  the  given  file.  Files  are  always  local  and  must 
already  exist.  Defaults  for  fields  you  omit  are: 

dtroctory:  logged  In  directory  (not  connected), 
name : SAVED 

extension:  MESSAGES 
version:  highest  existing 

File  name  addresses  are  omitted  from  the  message  heading. 


6.1.1  Editing  and  Viewing  Control  Characters 


There  is  no  way  to  edit  anything  but  the  current  item  being  typed  (i.e..  editing  won’t  go 
past  the  preceding  comma).  The  following  control  characters  edit  the  current  Item  or  kill 
the  whole  address  list. 
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Delete 

character 

tA 

DEL  key 

Delete 

current  word 

tw 

tw 

Delete 

entire  address  list 

tx 

tx 

Control  chiracters  for  viewing  addresses: 


Retypes  current  %K>rd 
Retypes  address  list 


6.1.2  Inserting  a File 


A file  containing  addresses  may  be  prepared  ahead  of  time  and  inserted  into  the  SNDMSG 
address  list.  Addresses  are  entered  on  the  file  exactly  as  they  would  be  typed  to  SNDMSG 
except  that  carriage  returns  from  a file  will  not  terminate  the  address  list  - thus,  addresses 
on  a file  may  appear  on  separate  lines  without  commas  if  desired. 


To  insert  the  file,  type  tR  (Control  B)  during  SNDMSG  address  input.  You  will  be  asked  for 
a file  name  and  for  confirmation  of  the  file  name.  The  file  is  read  into  the  address  list 
exactly  as  If  you  had  typed  it  in  manually.  When  SNDMSG  types  EOF  (End-OF-File),  you 
may  continue  entering  additional  addresses.  Input  is  terminated  by  typing  a carriage 
return. 


Although  files  are  often  used  to  hold  definitions  of  groups.  i.e..  they  often  start  with  a 
''<group  name>:".  files  and  groups  are  two  distinct  features.  The  purpose  of  a file  is  to 
permanently  hold  some  list  of  addresses.  The  purpose  of  a group  name  is  to  prevent  the 
component  address  from  cluttering  up  the  message  heading.  Although  groups  may  be 
defined  In  files,  they  may  also  be  typed  directly  Into  SNDMSG.  Files  inserted  into 
SNDMSG  need  not  define  groups. 


6.2  THE  SUBJECT  FIELD 


When  SNDMSG  prompts  for  “Subject*,  type  in  up  to  one  line,  terminated  by  carriage 
return.  You  may  type  Just  carriage  return  to  omit  having  a subject.  If  a subject  is  entered 
It  appears  In  the  heading  of  the  message.  The  same  control  characters  described  In  the 
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MESSAGE  FirM  Mction  apply  to  the  SUBJECT  field  with  the  following  additions  and 
exceptions. 

TrMEX  and  1OPS-20 

tZ  has  no  special  Meaning. 

tB  automatically  means  Insert  file,  never  Invoke  TECO. 
tX  deletes  the  tdiole  subject  and  starts  over. 


6.S  THE  MESSAGE  FIELD 


Wlirn  SNDMSG  prompts  for  “Message*  type  in  the  text  of  the  message.  When  you  are 
finished  composing  the  message  type  tZ  (Control  Z)  to  terminate  input  and  go  on  to  the 
next  stage. 

Various  control  characters  invoke  features  that  aid  In  composing  the  message.  They  are: 


TENEX 

TOPS-ZO 

Delete  previous  character 

tA 

DEL  key 

Delete  current  line 

♦0 

tU 

Delete  previous  trord 

tw 

fW 

Retype  the  current  line 

tR 

fR 

Retype  whole  message 

tS 

tD 

6.S.I  Inserting  Pre-composed  Text  and  Editing 


Whrn  dealing  with  large  messages  you  may  wish  to  prepare  your  message  ahead  of  time  on 
a file,  or  you  may  find  the  local  editing  characters  above  insufficient.  If  you  type  tB 
(Control-B).  SNDMSG  asks  whether  you  want  to  Insert  a file  or  invoke  TECO  (a  general  text 
editor). 

If  you  answer  "T*.  TECO  is  started  up  with  your  message  in  its  buffer.  When  you  exit 
TECO  (with  til)  the  edited  message  is  passed  back  to  SNDMSG  and  you  continue  composing 
the  message.  You  are  positioned  at  the  end  of  the  message,  as  if  you  had  Just  typed  It  into 
SNDMSG. 
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If  you  answer  "F".  SNDMSC  asks  for  (he  name  of  the  file  to  insert.  Type  the  file  name 
(the  usual  editing  characters  and  recognition  apply).  You  will  then  be  asked  to  confirm  by 
typing  carriage  return.  The  file  is  then  read  in  and  appended  to  any  text  you  have  already 
entered  and  "EOF"  (End-Of-File)  Is  typed.  You  may  then  terminate  Input  by  typing  TZ,  or 
continue  to  add  text  to  the  Message  field  until  your  message  is  complete,  then  type  tZ  to 
terminate. 


6.4  SENDING  THE  MESSAGE 


When  ali  information  has  been  entered  (addresses,  message,  etc.)  SNDMSG  asks  whether  to 
send  (he  mail  now  or  queue  it  for  later  delivery. 

If  you  answer  with  Just  a carriage  return  the  message  is  sent  immediately.  The  queueing  or 
sending  begins  after  this  command  is  given,  i.e.,  when  you  terminate  with  carriage  return. 
If  you  have  addressed  the  message  to  a file  using  « in  the  address  list,  SNDMSG  will  try  to 
deliver  it  even  if  queueing  is  in  effect. 

The  message  is  queued  for,  or  delivered  to,  each  of  the  addresses.  For  local  addresses  (ones 
in  which  no  host  was  specified)  duplicates  are  eliminated. 

SNDMSG  types  each  address  as  it  starts  to  process  it,  then  the  outcome.  There  are  three 
possible  outcomes: 

1.  "ok"  — (he  message  has  been  successfully  delivered  to  (he  address. 

7..  "queued"  — the  message  was  not  delivered,  but  has  been  queued  for  later 
delivery.  If  SNDMSG  queued  the  message  even  though  you  asked  that  it  be  sent 
immediately,  the  reason  it  had  to  be  queued  is  typed.  The  message  is  placed  in 
the  file  [-'lINSENT-MAlL-l-address  In  your  directory.  MAILER  will  deliver  it 
as  soon  as  possible. 

S.  "can't”  — (he  message  could  not  be  delivered  and  SNDMSC  did  not  queue  it 
in  the  (-llNSF.NT>MAlL-).address  file.  The  reason  is  typed  out  and  the 
message  is  pul  in  the  /UNDELIVERABLE-MAIL/.address  file  in  your  directory. 

If  (he  problem  was  that  the  name  was  misspelled,  you  have  the  option  to  correct 
(he  spelling  and  requeue  the  message  without  having  to  create  it  over  again  by 
using  (he  MAILSTAT  program. 
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7.  MSG  MESSAGE  HANDLING  PROGRAM 


MSG  is  a program  for  reading,  writing,  and  subsectioning  fiies  which  have  a "message  file 
format”.  It  is  very  simple  and  straightforward  to  use.  Commands  are  initiated  by  typing 
one  character,  which  causes  the  program  to  type  out  the  rest  of  the  command  name  and 
wait  for  input  from  you. 

Before  the  commands  are  described,  there  are  a few  general  statements  about  how  MSG 
works  and  some  conventions  used  in  describing  the  commands  that  you  should  know  about. 
The  prompt  characters  letting  you  know  that  MSG  is  waiting  for  a command  character  to 
be  typed  are  When  MSG  is  started  up  (by  typing  MSG<return>  to  the  EXEC)  it  will 
first  try  to  read  the  mailbox  file  in  your  directory  (named  MESSACE.TXT:(  in  TENEX; 
MA1I..TXT.I  in  TOPS-20).  your  directory.  If  this  file  does  not  exist  MSG  will  say  so.  If 
you  were  not  connected  to  your  login  directory,  MSG  will  try  to  find  a mailbox  file  there. 
If  that  also  fails,  it  will  say  so  and  wait  for  a command  to  be  typed.  If  you  have  a mailbox 
file,  it  will  scan  it  and  type  out  the  header  information  (i.e.  the  date,  from,  and  subject 
fields)  for  each  message  since  the  file  was  last  read,  preceded  by  a message  number 
sequentially  assigned  by  MSG.  These  message  numbers  are  used  in  association  with  the 
various  commands. 

However,  if  you  started  MSG  by  typing  MSG<space>  to  the  EXEC,  it  will  ask  you  for  a file 
to  be  read.  Typing  an  escape  as  the  first  character  will  cause  the  name  of  your  mailbox 
file  (MF.SSACE.TXT:I  or  MAIL.TXT.I)  to  be  typed  out.  and  confirmation  requested  from 
the  user  to  ensure  that  that  was  what  was  intended.  Once  a file  name  has  been  specified 
and  positively  acknowledged,  then  the  same  information  as  described  in  the  previous 
paragraph  will  be  output  to  your  terminal. 

When  reading  a message  file  in  MSG.  either  when  starting  up  MSG  or  with  the  Read 
command  described  below,  the  file  must  be  in  the  so^alled  "message  file  format".  If  MSG 
recognites  that  the  file  does  NOT  conform  to  this  format,  you  will  be  told  so.  However,  you 
will  be  given  the  opportunity  to  keep  everything  that  has  been  read  so  far,  but  NOT 
overwrite  the  Ikad'  file.  These  two  exceptional  circumstances  and  some  suggestions  for 
getting  around  them  are  described  at  the  end  of  this  manual. 

The  following  conventions  and  symbols  are  used  in  the  command  descriptions  below.  There 
are  only  five  types  of  Input  MSG  expects: 

(1)  a HS6  conmand  (or  sub-comaand)  character 

(2)  a atessaga  sequence  specification 

(3)  a TENEX  file  nane 

(4)  a conflrnatlon  character 

(5)  a local  user  nane  or  renote  site  nane 
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To  abort  output  to  the  terminal  type  tO  (control-O).  If  MSC  doe*  not  understand  your 
Input.  It  will  return  to  command  Input  mode,  or  reprompt  you.  The  following  are  symbols 
and  their  associated  meanings  used  In  the  command  descriptions: 

<FI1.E.NAME> 

Stands  for  any  TENEX  file  descriptor.  Including  TTY:  or  LPT:.  If  you  are  requested  to 
Input  a file  name,  the  appropriate  TENEX  confirm  will  be  given  (e.g..  [OM  version]). 

<MSC-SF.QUENCE> 

This  input  Is  prompted  by  the  string  (message  sequence)  In  verbose  typeout  mode.  A 
sequence  of  message  numbers  has  the  following  format. 

(I)  Any  single  message  number. 

(?)  Any  two  numbers  separated  by  ">"  or  V.  This  means  message  numbers 
driiniitcd  by  the  two  outside  numbers  (e.g..  2>5  means  messages  23.d4nd  5 in 
that  order).  NOTE:  if  the  first  number  is  greater  than  the  second  number.  It 
means  the  sequence  in  reverse  order  (e.g..  5>2  means  messages  5,43.  and  2). 

(.1)  A pair  of  numbers  separated  by  This  is  so  that  the  standard 
interpretation  of  the  string  "21-4"  (that  is  not  "21-24")  means  message  numbers 
21.  22.  25.  and  24.  Using  this  interpretation,  the  string  and  "24-1"  is  an  error. 

(4)  Any  sequence  of  the  previous  three  types  separated  by  commas.  This  is  the 
way  to  group  several  non-adjacent  messages  together.  For  example:  13.5:7.10 
means  messages  1 and  S and  5 through  7 and  10. 

<MSC-SEQUENCE>  of  the  types  described  above  are  ALWAYS  terminated  by  <return>. 

(5)  However,  there  are  special  types  of  message  sequences.  All  are  determined  by 
the  first  character  that  you  type  In  the  <MSC-SEQUENCE>  stream.  The 
following  are  the  thirteen  possibilities: 

1.  <escape>  Is  typed,  which  causes  the  current  message 
number  to  be  echoed  to  you  and  the  relevant  process 
performed  on  that  message  only. 

2.  <control-I>  Is  typed,  tthich  causes  the  previous 
completely  specified  <HS6>SEQUENCE>  to  be  echoed  and 
processing  performed  on  that  message  stream. 

3.  R which  stands  for  "Recent  messages"  only. 
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4.  0 standing  for  *01d  Messages"  only. 

5.  A standing  for  "All  messages"  and  which  Is  equivalent  to 
l:(1ast  message  number). 

6.  D standing  for  "Deleted  messages".  This  Is  valid  ONLY 
In  the  context  of  the  Headers,  Undelete,  and  Delete 
commands.  Everywhere  else,  the  headers  of  the  deleted 
messages  will  be  printed.  Of  course,  you  can  delete  the 
typeout  of  those  headers  by  typing  control -0. 

7.  U standing  for  "Undeleted  messages". 

6.  1 standing  for  messages  In  Inverse  order.  This  Is  the 

opposite  of  the  A (for  all  messages)  sub-command. 

9.  S for  "Subject  field  search  for  string"  which  asks  you 
to  provide  a string  which  will  be  used  as  a mask  match 
on  the  subject  field  of  the  message  headers. 

10.  f for  "From  field  search  for  string"  which  Is  like  S but 
searches  the  Author  field  of  the  message  headers 
Instead.  NOIE:  the  header  command  prints  the  initial 
part  of  the  To:  line  of  the  message  (If  It  exists)  Is 
the  message  was  sent  by  the  login-directory.  Therefore, 
to  search  for  messages  sent  by  yourself,  specify  the 
string  "To:"  rather  than  the  login  directory  name. 

1).  E standing  for  "Examined  messages",  I.e.  all  messages 
which  have  been  completely  typed  (with  the  T command)  or 
listed  (with  the  L command). 

12.  N standing  for  "Not  examined  messages",  which  Is  the 
opposite  of  the  E sub-command. 

13.  L standing  for  the  "Last  message  sequence"  that  was 
completely  specified. 


Types  (I)  and  (j)  rrquirc  you  to  type  a string  terminated  by  <return>.  Typing 
Just  a <return>  (i.e.  the  null  string)  means  that  searching  Is  not  to  be  performed. 
Oiherwise.  the  search  will  be  performed  on  the  string  typed  up  to  (but  not 
including)  the  <relurn>.  The  string  you  type  must  be  an  exact  match  to  some 
substring  of  the  appropriate  field,  but  all  alphabetic  characters  are  treated  as 
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listing  are  ignored.) 
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(6)  (Note:  This  is  an  experimental  feature  which  may  change  in  the  future.)  If 
you  type  comma  or  "M”  as  the  first  character  of  the  message  sequence  that  you 
are  specifying,  you  will  be  able  to  specify  more  than  one  of  the  options  drawn 
from  the  first  five  items  mentioned  here.  You  will  then  be  entered  into  a sub- 
rouiinand  mode.  Any  of  the  standard  message  sequences  are  acceptable  as 
input.  To  terminate  the  specification  of  the  list  of  message  sequences,  just 
type  a carriage  return  in  response  to  the  prompt.  If  you  wish  to  abort  the 
acquisition  at  any  time,  type  "Q"  (for  Quit)  or  control-N  (tN).  To  abort  the 
acquisition  of  a single  message  sequence  (like  S:I4),  type  rubout.  Typing  rubout 
at  the  sub-command  level  (i.e.  at  the  prompt  without  typing  anything  first) 
will  have  the  same  effect  as  typing  control-N. 

The  default  message  sequence  is  *AII  messages'.  Any  message  sequence  specified 
causes  an  intersection  to  be  taken  between  that  single  message  sequence  (like 
’Examined*),  and  the  previous  total.  For  example,  the  sequence: 

<-  Headers  , 

<<-  Examined 

<<-  From  string:  SYSTEM 

«- 


would  cause  only  the  headers  corresponding  to  messages  from  SYSTEM  which 
have  already  been  typed  to  get  listed  on  your  terminal. 

If  you  ju.st  want  to  add  a message  sequence  to  the  list,  preface  the  actual 
message  sequence  with  a "P”  (for  Plus)  or  If  you  want  to  just  subtract  a 
message  sequence  from  the  list,  preface  the  actual  message  sequence  with  an 
"M"  (for  Minus)  or  For  example, 

<-  Headers  Multiple  aiessage  sequences 

<<-  Examined 

«-  From  string:  SYSTEM 

«-  Plus:  Subject  string:  MSG 

<<-  Minus:  Deleted 

«- 


will  list  the  headers  for  all  undeleted  messages  about  MSG  or  which  are 
examined  messages  from  SYSTEM.  No  further  associations  between  msg- 
sequence  specifications  are  currently  allowed. 
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In  thr  command  format  below,  evcrythinf  that  the  program  types  will  be  lower  case  and 
everything  you  type  will  be  In  UPPER  CASE.  This  is  not  the  case  when  using  MSG,  but  is 
used  here  for  clarity. 


7.1  MSG  COMMANDS 


<~  Headers  (message  sequence)  <HS6-SEQUENCE> 

Thr  hraders  for  messages  will  be  typed  out  for  those  messages  defined  by  the  message 
srqurnre  typed.  Headers  corresponding  to  deleted  messages  have  an  asterisk  printed  before 
the  header  for  that  particular  message.  The  headers  for  recent  messages  are  preceded  by  a 
plus  sign  (4);  messages  which  have  not  yet  been  typed  are  preceded  by  a minus  sign  (•),  and 
deleted  messages  are  preceded  by  an  asterisk  (•).  If  the  message  was  sent  by  the  user  of  the 
LOGIN  directory,  thr  initial  part  of  the  To:  field  of  the  message  will  be  printed  in  the 
author  field  of  the  header,  if  the  To:  field  exists  in  the  message.  In  order  to  get  the  length 
of  thr  message  typed  out  along  with  the  header,  use  the  I command  (which  stands  for 
Inclusion  of  length  in  header). 

<~  Delete  (aiossage  sequence)  <HSG-SEQUENCE> 

This  command  will  indicate  (by  a preceding  asterisk)  in  the  header  information  for  the 
messages  specified  by  <MSG-SEQUENCE>  that  those  message  are  deleted.  NOTE:  This 
command  marks  each  message  in  the  actual  message  file  indicating  that  it  is  deleted.  If 
you  reread  the  file  for  some  reason,  the  messages  will  still  be  marked  (and  treated)  as  deleted 
(but  not  expunged).  This  command  does,  however,  affect  message  numbers  specified  in 
later  commands  in  the  following  way.  If  you  have  deleted  message  number  5 and  then  try 
to  "Type"  or  "Put”  message  number  S either  directly  or  implied  by  the  use  of  the  V option, 
the  deleted  messages  will  NOT  be  included. 

<-  Undelete  (message  sequence)  <HSG-SEQUENCE> 

Of  coursel  If  you  can  delete  a message,  you  certainly  ought  to  be  able  to  undelete  it.  This 
command  undoes  the  action  of  the  Delete  command  for  the  messages  specified  by  this 
<MSGSEQUENCE>. 


7.1.1  Commands  To  See  And  Move  Messages 


<-  Typo  (message  sequence)  <HSG*SE(^NCE> 
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This  command  will  type  on  your  terminal  the  messages  specified  by  <MSC-SEQUENCE>. 
All  messages  which  are  completely  typed  are  treated  as  having  been  ’examined’. 

<•  Put  (message  sequence)  <HSG-SEQUENCE> 

Into  file  name:  <nLE>NANE> 

This  command  will  put  the  messages  specified  by  <MSC-SEQUENCE>  into  the  file 
specified  by  <FILE>NAME>.  If  the  file  does  not  exist,  it  will  create  that  file  and  write  the 
messages  into  it.  If  the  file  already  exists,  it  will  append  the  messages  to  the  messages 
already  In  the  file.  This  command  is  useful  if  you  want  to  keep  separate  files  containing 
messages  concerning  different  topics. 

<-  Novo  (message  sequence)  <NSG-SEQUENCE> 

Into  file  name:  <MLE-NANE> 

This  command  is  a convenient  combination  of  the  Put  and  Delete  commands.  As  the 
messages  are  put  into  the  file,  they  are  marked  for  deletion.  If  any  of  the  messages  are 
already  deleted,  you  will  be  informed,  and  those  messages  will  NOT  be  moved  to  the  file. 

<-  List  (message  sequence)  <NSG-SEQUENCE> 
on  file:  <F1LE-MAME> 

This  command  lists  all  the  specified  messages  on  the  file  specified.  All  messages  specified 
by  the  <MSC-SKQUENCE>  are  treated  as  having  been  examined  (typed).  If  you  are  listing 
more  than  one  message,  a preface  page  on  the  file  containing  the  headers  for  those 
messages  will  be  created.  You  will  be  asked  if  you  want  each  message  on  a separate  page. 
This  command  is  intended  to  allow  a user  to  obtain  a reasonable  hard  copy  listing  of  some 
messages.  (Note:  the  preface  page  of  headers  might  have  the  length  of  each  message 
included  depending  on  the  setting  by  the  Knclusion  of  length  in  header)  command.) 


1.\.7.  Commands  To  Update  Your  Message  Files 


<-  Overwrite  old  file  <F11E-NANE>  [confirm] 

This  command  will  overwrite  the  current  file  (specified  by  <FILE-NAME>).  reflecting  the 
fart  that  you  have  deleted  messages.  That  is,  if  you  delete  message  2 and  then  "overwrite" 
your  file,  message  2 will  disappear  from  that  file.  It  also  rereads  your  file,  renumbering 
your  messages.  You  are  warned  If  any  unexamined  messages  (which  are  also  not  deleted) 
exist  In  the  file  that  you  are  overwriting. 

<-  Quit  [confirm] 
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This  command  returns  you  to  the  TENEX  EXEC  without  rewriting  any  file  (almost 
equivalent  to  typing  control-C)i  You  are  warned  If  any  unexamlned  messages  (which  are 
also  not  deleted)  exist  In  the  current  message  file. 

<>  FxH  and  update  old  file  <F1LE-NMIE>  [conflrn] 
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This  command  Is  another  way  to  Overwrite  your  old  message  file,  but  Instead  of  rereading 
the  file  it  returns  you  to  the  TENEX  EXEC.  This  is  equivalent  to  doing  an  overwrite 
followed  by  a Quit,  but  without  the  overhead  of  rereading  the  file.  You  are  warned  if  any 
unexamlnH  messages  (which  are  also  not  deleted)  exist  in  the  file  that  you  are  overwriting. 

<-  Write  file  <FILE-NAHE>  sorted  by  nessage  arrival  time 

This  is  similar  in  nature  to  the  Overwrite  command,  except  that  the  messages  are  sorted 
into  ascending  sequence  by  their  arrival  time  before  the  overwriting  is  attempted.  The  file 
Is  then  rescanned.  You  are  warned  if  any  unexamlned  messages  (which  are  also  not  deleted) 
exist  in  the  file  that  you  are  sorting. 
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7.1.S  Commands  To  Read  Other  Message  Files 


<-  Read  file  name:  <I11E-MAME> 

You  can  use  MSC  on  any  file  which  has  a "message  format."  This  means  you  can  peruse  or 
modify  files  created  with  the  "Put"  or  "Move"  commands  (but  NOT  the  "List"  command). 
If.  for  example,  you  have  a file  containing  messages  pertaining  to  MSC  problems,  you  can 
read  it  to  make  sure  you’ve  taken  care  of  them.  Read  is  the  command  which  lets  you  read 
files  other  than  your  standard  mailbox  file  (MESSACE.TXTil  or  MAIL.TXT.1).  It  also 
prints  out  the  recent  header  information  for  that  file.  If  that  file  has  old  messages  which 
have  not  yet  been  ’examined’,  you  will  be  informed.  You  will  also  be  told  if  any  of  the  old 
messages  In  the  file  are  deleted. 
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7.1.4  Commands  To  Sequence  Through  The  Messages 


<-  Current  aiessage  Is  nn  of  mm  aiessages. 
In  file:  <FILE-IIM1E> 


This  command  tells  you  (1)  the  number  of  the  current  message.  (2)  the  total  number  of 
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iiirisages,  and  (S)  tlir  filr  name  of  the  currently  active  file.  The  current  message  is  either 
the  last  message  typed  on  yuur  terminal  or.  if  you  have  not  typed  one  yet,  either  after  the 
last  message  if  the  file  had  no  recent  messages,  or  before  the  first  recent  message.  This 
command  will  let  you  know  where  the  Next  and  Baching  up  commands  will  start,  l.e.  the 
first  message  they  will  type  if  used.  Finally,  it  will  tell  you  what  the  currently  active 
message  file  is. 

<-  Go  to  message  number:  <NUItBER> 


This  will  allow  you  to  change  the  Current  message  number  explicitly.  If  <NIIMBER>  Is  not 
in  the  range  of  acceptable  numbers  (i.e.  it  is  less  than  I or  greater  than  the  number  of 
messages  in  the  file),  or  you  did  not  type  a number,  you  will  be  toM  and  the  Current 
message  number  will  not  be  changed.  However,  there  are  several  other  options  which  arc 
specified  by  the  FIRST  character  typed: 

a.  E for  the  end  of  messages  (the  last  message) 

b.  L for  the  last  message  (same  as  E). 

c.  B for  the  beginning  of  messages  (message  number  1) 

d.  escape  (alt-mode)  for  current  message  number 


<-  Next  message  is: 

This  command  types  the  message  following  the  current  message  (if  one  exists)  and  sets  the 
"current  message"  to  be  that  message.  Deleted  messages  will  not  be  typed,  but  the  "current 
message  number"  will  still  be  incremented. 

<-  <lino  feed> 

Same  as  Next.  Types  the  message  following  the  current  message,  and  sets  the  current 
message  to  be  that  message. 


f- 


<-  Backing  up  --  previous  message  Is: 

This  command  always  types  the  previous  message  (i.e..  Current  message  number  • 1).  It  is 
the  inverse  of  the  Next  command.  It  always  decrements  Current  message  number. 

<-  » 


This  is  equivalent  to  the  Back  command.  It  types  the  previous  message  and  sets  the  current 
message  to  be  that  message. 


<-  tH 

The  <control-H>  (or  Newsline)  command  is  equivalent  to  the  Back  command.  It  types  the 
previous  message  and  sets  (be  current  message  to  be  that  message. 
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7.1.5  Other  Commaiids 


<-  Verbose 


This  is  a binary  switch  which  causes  the  program  to  §^0  Into  either  'Short  typeout  mode’  or 
l-ong  typeout  mode*,  and  tells  you  which  Is  the  setting  that  it  changes  to.  The  default  Is 
'Short  typeout  mode*.  Long  typeout  mode  gives  additional  prompting  about  what  is 
expected  to  be  typed  in. 


<>  Konciso 


This  is  a binary  switch  which  causes  the  program  to  go  into  either  ‘Concise  typeout  mode* 
or  'Short  typeout  mode*  (the  defaults  and  tells  you  which  is  the  setting  that  it  changes  to. 
Concise  typeout  mode  shortens  some  of  the  typeout  that  MSG  gives  when  it  is  interacting 
with  the  user.  It  is  meant  for  'advanced*  users  only. 


<-  Inclusion  of  length  In  header 


This  rninmand  is  a binary  switch  which  causes  the  program  to  go  Into  a mode  where  header 
listings  caused  by  the  Header  command  will  have  the  number  of  characters  In  the  message 
included  as  part  of  the  subject  field.  The  default  Is  that  the  length  will  not  be  Included. 
Note  that  when  you  read  a file  Initially,  the  length  of  'recent*  messages  will  always  be 
Included  In  the  Initial  listing  of  recent  headers. 


<>  Zap  profile  [Confirn] 


The  Zap  profile  command  will  allow  you  to  set  up  a user  profile  file  for  yourself  without 
having  to  know  the  format  of  such  a file.  For  the  time  being,  the  profile  information  will 
be  limited.  Typing  controhN  Will  exit  you  to  the  command  level  of  MSG.  Typing  E at 
any  point  will  ‘F.xlt'  the  dialogue  and  ask  you  if  you  want  the  changes  made  permanently. 
At  any  point,  type  *7'  to  determine  the  appropriate  responses.  The  following  Is  a summary 
of  the  questions  posed: 


Nornal,  Verbose  or  Koncise  typeout  nodef 

Always  Include  the  length  of  nessages  In  all  headers 

listings? 

When  In  SN0NS6  (fron  any  of  the  SndnsOi  Forward  or  Answer 
coaaaands),  when  you  type  control'll,  do  you  want  to  abort 
Sndnsg  without  conflnaatlonT 


I 


I 


t 


4.  Do  you  want  to  be  required  to  confirm  all  commands  with  a 
single  carriage  return? 

5.  Do  you  want  to  be  told  that  some  messages  have  been 
'not>exam1ncd'  whenever  you  try  to  quit  MSG  (by  any  of  the 
Quit.  Overwrite,  or  Exit  and  Update  commands)? 

6.  Do  you  want  to  receive  copies  of  your  'answers'  to  messages? 

7.  If  the  answer  to  (6)  Is  yes,  then  you  will  be  asked  If  you 
want  to  save  all  your  'answers'  on  the  file  SAVED. MESSAGES. 

8.  Do  you  want  a list  of  headers  for  all  messages: 

a.  being  deleted  with  either  the  "Move"  or  "Delete" 
commands 

b.  being  moved  with  the  "Put*  command 

c.  being  listed  with  the  "List*  or  "Xerox*  command 

d.  being  marked  or  unmarked  with  the  ■'*  or  commands. 


At  flip  end  of  the  dialogue,  you  will  be  asked  If  you  want  these  changes  in  mode  settings  to 
be  made  permanent.  If  you  answer  'Y'  then  each  time  you  start  up  MSG,  the  settings  of  the 
modes  noted  here  will  be  set  to  the  values  you  indicated.  Otherwise,  the  settings  are  set  only 
for  this  session.  They  are  NOT  permanent,  and  can  be  changed  any  time. 

<-  : (prints  current  time  and  date) 

<>  ' Mark  messages  as  examined  (message  sequence)  <MSG-SEQUENCE> 

This  command  will  mark  all  the  messages  specified  by  <MSC-SEQUENCE>  to  be 
‘‘examined’,  so  MSG  will  think  they  have  been  typed  or  listed  even  though  they  may  not 
have  been. 

<•  • Unmark  messages  to  be  Not  examined  (message  sequence)  <MSG-SEQUENCE> 

This  command  will  mark  all  the  messages  specified  by  <MSG*SEQliENCE>  to  be  "NOT 
examined",  so  MSG  will  think  they  have  NOT  been  typed  or  listed,  even  though  they  might 
have  already  been  seen. 

<>  ; <COMMENI> 

This  command  is  mainly  intended  to  allow  you  to  talk  with  somebody  over  a link  while  you 
are  In  MSG.  It  eats  all  characters  except  <return>,  control-Z  (tZ)  and  control-N  (tN),  which 
return  you  to  the  command  level  of  MSG.  Two  other  characters  have  special  effects. 
<delete>  (<rub-out>)  will  type  the  string  ’ XXX  ' and  is  useful  in  indicating  that  the  previous 
word  (or  phrase)  should  be  ignored.  <line>fced>  will  cause  effectively  a carriage  return  and 
tab  sequence  be  typed.  This  way  you  can  type  more  than  one  line  of  text.  NOTE:  the 
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•tandard  TENEX  and  TOPS-20  editing  character*  (e-f^  tA  or  the  DEL  hey)  arc  treated  like 
any  other  character  and  perform  no  special  fnnction. 


7.1.6  Command  To  Run  Other  Programs 


<-  SndmsQ  [conrtrn] 

This  command  will  start  up  SNDMSC  and  give  control  of  the  terminal  to  it.  When 
SNDMSC  is  finished  (i.e..  when  you  have  sent  the  message^  It  will  turn  control  back  to  MSG 
in  the  same  state  as  it  was  before  you  sent  the  message.  Control-N  (tN)  will  ask  If  you  wish 
to  abort.  If  you  provide  a positive  confirmation,  then  you  will  be  returned  to  the  top  level 
of  MSG.  Otherwise,  you  will  be  returned  to  SNDMSC. 

<-  Answer  aiessage  number:  <HESSAGE*NUN6ER> 

Reply  to  those  whom  the  message  Is:  <ANSWER  SUB-COHHAND> 

This  facility  allows  you  to  send  a message  to  the  sender  of  a message,  and  (at  your 
discretion)  those  people  to  whom  that  message  was  sent,  without  having  to  type  their 
addresses  to  SNDMSC. 

Tho  <ANSWER  SUB-CONNAND>  can  be  any  of  the  following: 

F •-  From  (Indicating  the  sender  of  the  message  only) 

T To  (Indicating  the  sender  of  the  message  and  those 
addresses  In  the  To:  list)  ^ 

C >-  Cc  (Indicating  all  recipients  of  the  original  message 
In  addition  to  the  sender  In  the  message) 

Typing  anything  else  aborts  the  command. 

Tho  <HESSAGE*NUHBER>  can  bo  any  argument  that  the  Go  command  takes: 

a.  a awssago  number 

b.  E for  the  end  of  messages 

c.  L for  tho  last  messaga  (same  as  E). 

d.  B for  the  beginning  of  messages  (message  number  1) 

o.  escape  (alt-mode)  for  current  message  number 

r.  <roturn>  for  current  message  number. 

The  header  of  the  message  specified  is  also  typed  ao  that  you  may  be  sure  you  are 
answering  the  correct  message.  In  fact,  the  header  Is  typed  after  you  have  specified  the 
message  number,  but  before  you  are  asked  to  supply  the  sub-command. 
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When  prompted  for  additional  addresses,  any  that  you  specify  will  be  passed  to  SNDMSC 
as  part  of  the  cc:  list.  Some  of  the  SNDMSC  conventions  are  NOT  implemented.  These  are 
the  confrol-B  feature  which  allows  specification  of  a file,  and  the  feature  which  allows  you 
to  specify  a global  host  name  (which  spreads  across  several  user  names).  Also.  control-N 
aborts  the  Answer  command!  Local  user  names  and  remote  host  names  are  checked  for 
validity. 

An  attempt  Is  made  to  insure  that  all  addresses  are  valid  (i.e..  all  host  names  on  remote 
addresses,  and  user  names  on  local  addresses),  and  that  no  duplications  are  present.  If 
clarification  is  necessary  from  the  user,  you  may  be  asked  some  questions.  If  these 
questions  are  posed,  all  type-ahead  is  deleted.  If  relevant.  MSC  will  issue  a warning  if  either 
the  To:  or  cc:  destination  fields  of  the  message  have  a destination  list  as  part  of  the  field 
(like  LISP-USERS:).  When  control  is  given  to  you  to  type  your  answer,  you  will  be  typing 
to  the  message  acquisition  portion  of  SNDMSC  (i.e.,  that  part  which  normally  would 
prompt  you  by  typing  "Message  (?  for  help):").  Control-N  (tN)  will  ask  If  you  wish  to 
abort.  If  you  give  positive  confirmation,  then  you  will  be  returned  to  the  top  level  of  MSC. 
Otherwise,  you  wili  be  returned  to  SNDMSC. 


i 


I 


I 


There  are  two  relevant  profile  mode  settings.  One  is  whether  you  wish  to  receive  copies  of 
the  answers  you  send.  It  is  initially  assumed  that  you  do.  If  you  do  not  want  copies  of  the 
replys  you  send,  then  your  name  will  not  appear  in  any  of  the  destination  lists  unless  you 
specify  it  as  part  of  the  additional  carbon-copy  list.  However,  if  you  do  want  copies  of 
your  messages,  you  will  always  receive  one.  In  addition,  if  you  have  also  indicated  in  your 
profile  that  you  want  all  your  responses  to  go  to  a file  called  SAVED.MESSACES.  then  if 
that  file  exists,  your  responses  will  go  in  that  file  and  NOT  into  your  mailbox  file 
(MFSSACE.TXT:I  or  MAIL.TXT.}). 

However,  if  you  do  not  always  want  your  answers  to  go  to  SAVED.MESSACES.  but  do  want 
copies  of  your  answers.#!  there  is  a file  named  SAVED.MESSACES  in  the  login  directory, 
you  will  be  asked  if  you  want  your  copy  of  the  message  to  go  to  that  file.  If  a positive 
response  it  given,  then  the  login  directory  name  will  NOT  appear  in  the  destination  lists. 

<>  Forward  (aicssage  sequence)  <HSG*SEQUENCE> 

This  facility  will  allow  you  to  send  copies  of  messages  you  have  received  to  other  people. 
The  headers  of  the  messages  being  forwarded  are  typed,  after  which  you  will  be  asked  to 
provide  the  subject  of  this  forwarded  message.  Then  it  will  hand  SNDMSC  the  subject  and 
those  messages  you  want  forwarded,  and  leave  you  in  SNDMSC  in  such  a way  that  the 
message  being  forwarded  can  be  edited,  or  your  own  comments  added.  You  wili  be  left  in 
SNDMSC  as  though  you  had  typed  the  forwarded  message  in  yourself.  When  done,  type  a 
control-7,  and  then  specify,  in  the  standard  way.  to  whom  the  mail  is  going.  Once  in 
SNDMSC.  typing  control-N  (tN)  will  ash  if  you  wish  to  abort.  If  you  give  a positive 
confirmation  In  the  standard  way.  then  you  will  be  returned  to  the  top  level  of  MSG. 
Otherwise,  you  will  be  returned  to  SNDMSC. 


7.  MSC  MKSSACE  HANDLING  PROGRAM 


0 

e 

0 


Pane  Sccsiaa  I.IA 


<-  Jump  Into  lower  fork  running:  <FILf-NANE> 

This  command  is  an  escape  in  MSC  in  case  you  wish  to  run  another  program  such  as 
TFCO.  PUB.  the  EXEC,  and  so  on.  It  searches  directories  to  try  to  find  the  program  you 
are  asking  it  to  run.  The  search  list  Is.  in  order.  <SUBSYS>.  <SYSTEM>.  your  connected 
directory,  and  the  login  directory  (if  It  is  different  from  your  connected  directory).  This 
way,  you  can  run  EXEC  without  having  to  type  the  complete  information  (l.e., 
<SYSTEM>EXEC.SAV). 

If  you  decide  to  leave  the  lower  fork,  but  want  to  continue  it  at  a later  time,  all  you  need  do 
is  type  an  escape  as  the  first  character  of  the  file  name  you  are  requested  to  provide.  This 
will  cause  the  old  file  name  (preceded  by  an  appropriate  message)  to  be  printed,  and  then 
you  will  be  asked  to  confirm  in  the  standard  way.  If  you  provide  a positive  confirmation, 
you  will  be  asked  if  you  want  to  continue  or  start  that  program.  Typing  ’C  for  continue 
will  pul  you  back  in  the  lower  fork  at  the  place  where  you  exited;  typing  ’S*  for  start  will 
restart  the  program. 

<-  Xod  (editor)  [confirm] 

This  command  will  start  up  XED  (a  text  editor  written  at  ISI).  It  has  the  capability  to  give 
SNDMSC  the  text  built  while  in  the  editor  as  the  body  of  the  message.  When  you  “Quit” 
XEO  you  will  return  to  MSC.  Each  additional  time  that  you  execute  the  XED  command, 
you  will  be  returned  to  the  SAME  copy  of  XED  that  you  previously  left  with  the  XED 
“Quit”  command  (the  old  text  buffers  are  left  intact). 

<-  tfxcc  [confirm] 

When  you  type  control-E,  the  program  will  type  "Exec"  to  you  and  ask  for  confirmation. 
This  command  is  intended  to  give  you  a new  copy  of  the  EXEC  with  a minimum  of 
hassles.  To  leave  that  EXEC  and  return  to  MSC.  type  “QUIT".  If  you  decide  that  you  want 
a copy  of  the  EXEC  again,  and  you  use  this  command,  you  will  be  given  the  same  EXEC 
with  all  of  your  context  intact. 


7.1.7  Command  Summary 


Camd. 

Char.  Henning 

A Answer  message  number:  <NESSA6E-IIUNBER> 

Reply  to  tdiom  the  message  Is: 
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F — Fro« 

<return>  •"  same  as  F 
T — To  list  plus  original  sender 
C --  Cc  list  plus  To:  list  plus  original  sender 
Backing  up  --  previous  message  Is: 

Same  as  Backing  up 
Same  as  Backing  up 
Current  message  Is  nn  of  mm  messages 
In  rile:  <FILE-NAHE> 

Delete  (message  sequence)  <HSG*SEQUEIICE> 

Exec  [confirm] 

Exit  and  update  old  file  <FILE'NAHE>  [confirm] 

Forward  (message  sequence)  <nS6-SEQUENCE> 

Go  to  message  number:  <HESSAGE'NUHBER> 

Headers  (message  sequence)  <HS6>SEQUENCE> 

Inclusion  of  length  In  header 

Jump  Into  lower  fork  running  file;  <program  name>  [confirm] 
Konciso  -*  provides  shorter  prompting 
List  (message  sequence)  <NS6*SEQUENCE> 
on  rile  name:  <FILE-NAHE> 

Hove  (message  sequence)  <HSG-SEQUENCE> 

Into  rile  name;  <F1LE-NANE> 

Next  message  Is: 

(line  feed)  same  as  Next  message  Is: 

Overwrite  old  file  <FILE-NAHE>  [confirm] 

Put  (message  sequence)  <HSG-SEQUENCE> 

Into  file  name:  <FILE-NANE> 

Quit  [confirm] 

Read  file  name:  <FILE-NANE> 

Sndmsg  [confirm] 

Type  (message  sequence)  <HSG‘SEQUENCE> 

Undelete  (message  sequence)  <HSG-SEQUENCE> 

Verbose  --  provides  more  prompting 

Write  file  <FILE-NAHE>  sorted  by  message  arrival  time  [confirm] 
Xed  [confirm] 

Zap  profile  [confirm] 

* Hark  messages  as  'examined'  (message  sequence)  <HSG-SEQUENCE> 
- Unmark  messages  to  be  NOT  'examined'  (message  sequence) 

<HSG-SEQUENCE> 

(the  time  and  date  Is  then  printed) 

T Type  command  character  for  Its  description,  ? for  summary 
; Comment  --  <return>  or  tZ  returns  you  to  command  level 


Abort  commands  on  typein  and  terminal  output  wHh  control-N  (TN).  Confirm  with  Y or 


<rrturn>. 
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7.2  RECEIVING  NEW  MESSAGES  WHILE  USING  MSG 


MSG.  on  typing  a command  or  returning  from  the  execution  of  a command,  checks  to  see 
if  your  currently  active  message  file,  usually  MESSAGE.TXTU  or  MAIL.TXT.1,  has  been 
written  into.  If  it  has.  it  prints  out  that  fact  and  the  headers  for  the  new  messages.  The 
"current  message  number"  Is  not  modified.  It  then  executes  your  command  or  returns  to 
command  mode,  accordingly. 


7.S  ERRORS  WHILE  READING  A MESSAGE  FILE 


When  reading  a file  in  MSG  (cither  at  startup  or  with  the  'Read'  command),  the  file  MUST 
be  in  the  so-called  "message  file  format".  If  MSG  recognises  that  the  file  does  NOT 
conform  to  this  format,  you  will  be  told  so.  The  following  are  the  circumstances  which 
might  cause  the  file  to  become  unreadable,  and  some  suggestions  for  getting  around  the 
problems. 

The  file  is  a message  file  (that  is.  one  or  more  valid  messages  have  been  read  from  it),  but 
somewhere  in  the  middle  it  does  not  conform  to  the  message  file  format.  It  could  be: 

(1)  It  has  a hole  in  it.  Read  the  file  with  a text  editor  to  get  rid  of  the  hole,  and 
write  it  back  out.  and  reuse  MSG.  Try  this  first. 

If  this  doesn't  work.  MSG  will  give  you  an  error  at  the  same  place.  Then  you  can  try  the 
second  suggestion: 

(2)  If  suggestion  (I)  didn't  work,  then  the  file  has  internal  byte  counts  which  do 
not  match  the  actual  file.  Either  you  used  a text  editor  on  your  message  file 
rlianging  the  number  of  bytes  but  not  the  byte  counts  or  your  file  was 
mysteriously  altered.  The  dale  of  a message  could  not  be  read.  Either  the  byte 
rminl  for  the  last  message  read  was  wrong,  or  there  is  junk  between  the  last 
message  read  and  the  one  with  the  error.  Using  some  editor,  find  the  last 
message  read.  The  first  line  of  that  message  contains  a date-and-time  followed 
by  a byte  count  indicating  how  many  characters  are  in  the  message  body 
starling  on  the  following  line.  Skip  that  many  characters  of  the  message  body. 

You  should  be  at  the  date-and-time  line  of  the  next  message.  If  there  is  junk 
there,  delete  it.  Otherwise,  try  to  fix  the  count  so  it  Is  pointing  at  the  date-and- 
time  of  the  next  message. 

The  beginning  of  the  file  does  not  conform  to  the  message  file  format.  It  couM  be: 

(1)  the  file  Is  not  a message  file  ~ sorry,  we  cant  help  you  there. 
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(2)  It  is  a message  file  witli  a bad  first  line  ••  probably  a blank  line.  Read  the 
file  with  a text  editor.  If  the  second  line  begins  with  a time  and  date,  then 
delete  the  first  line  and  reuse  MSG  on  the  new  file. 


G 


(S)  It  is  a message  file  with  a hole  at  the  beginning.  Read  it  with  a text  editor 
to  get  rid  of  the  hole,  write  it  out  and  reuse  MSG. 
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The  following  was  excerpted  from  Bolt  Beranek  and  Newman.  Inc.  THE  HERMES 
MESSAGE  SYSTEM  on-line  documentation. 

Copyripht  C 1977  Bolt  Beranek  and  Newnan,  Inc. 

Reprinted  by  peraiisslon. 


The  HERMES  Message  System  is  a computer  program  for  sending  and  receiving  messages 
over  a computer  network.  The  HERMES  System  has  features  that  help  the  user  read 
messages,  compose  messages  for  sending,  and  create  and  manage  files  of  messages.  The 
HERMES  Message  System  is  one  product  of  Project  HERMES,  a Bolt  Beranek  and  Newman. 
Inc.,  research  and  deveiopment  effort  in  advanced  forms  of  message  technology.  Project 
HERMES  Is  supported  by  the  DoD  Advanced  Research  Projects  Agency,  by  the  Naval 
Electronics  Systems  Command,  and  by  the  (J.  S.  Army  Development  and  Readiness 
Command.  The  HERMES  program  was  first  implemented  for  host  computers  using  the 
TENEX  Executive  System  developed  at  Bolt  Beranek  and  Newman.  Inc.  for  the  DEC  PDP- 
10  computer.  In  1977.  HERMES  was  modified  to  run  on  the  TOPS-20  Operating  System.  In 
this  documentation,  the  operating  system  is  referred  to  as  TOPS-20'‘  or  the  ’’Exec”. 

The  HERMES  Message  System  contains  an  indexed  set  of  on-line  documentation.  Without 
entering  any  special  subcommand  mode  you  can  obtain  succinct  information  or  extensive 
documentation  about  any  topic.  The  documentation  is  available  using  four  HERMES 
commands:  DESCRIBE.  OUTLINE.  EXAMPLE,  and  DOCUMENT.  The  commands  are  used 
to  request  information  about  specific  topics  in  the  HERMES  system.  There  is  also  a HELP 
facility  for  new  usns  and  a NEWS  facility  to  keep  users  posted  on  recent  modifications  to 
the  HERMES  system.  The  HELP  command  is  designed  to  aid  users  just  getting  started 
with  HERMES.  HELP  presents  basic  topics  and  asks  the  user  to  choose  the  ones  to  be 
printed  out.  For  basic  instructions  for  using  the  HERMES  system,  type  HELP: 

>liELP<CR> 


HELP  tells  you  how  to  use  the  on-line  documentation  commands.  OUTLINE.  DESCRIBE. 
EXAMPLE  and  DOCUMENT,  which  provide  detailed  information  about  the  system.  The 
NEWS  command  provides  users  with  a summary  of  recent  modifications  to  the  HERMES 
system.  In  addition  to  NEWS,  there  is  a topic  NEW-FEATURES,  which  can  be  accessed  by 
the  normal  documentation  commands  DESCRIBE.  OUTLINE.  EXAMPLE,  and 
DOCUMENT.  Any  changes  mentioned  in  NEWS  are  also  available  as  subtopics  of  NEW- 
FEATURES.  To  obtain  a complete  list,  type: 

XXITLINC  NCV-FEATURES  ALL<CR> 
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To  print  the  latest  News  on  your  terminal,  type  NEWS. 


I 

I 
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I 
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>NCWS<CR> 

You  can  also  output  News  or  Help  to  the  line*printer  or  a file. 

>NrWS  LPI:<CR> 
or 

>NEWS  <ri)e-name><CR> 

>liriP  LP1:<CR> 
or 

>HELP  <ri1e-Rame><CR> 

If  you  have  suggestions  or  questions,  please  use  the  SUGGESTION  command: 
>SUGGESTION<CR> 

This  is  a quick  and  easy  way  to  tend  a message  to  the  Hermes  staff. 
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8.1  PANIC  BUTTONS 


<CTRL-0>  stops  print-out  of  text  anywhere;  prints  to. 

<C1RL-U>  stops  a conmand  before  the  final  <CR>. 

<CTRL-E>  stops  a command  at  any  time;  prints  tE. 

<C1RL-C>  stops  HERMES  anywhere  and  returns  you  to  the 
operating  system;  prints  tC.  You  can  recover 
by  typing  CONTINUE  to  the  9 prompt. 

To  type  a control  character,  e.g.,  <CTRL*C>.  hold  down  the  CTRL  key  while  you  type  the 
letter  C. 

NOTE:  Occasionally,  by  accident,  you  may  get  Info  a program  that  runs  under 
Hermes  in  a “lower  fork”.  Such  a program  will  have  a different  prompt  (such 
as  In  this  situation,  <CTRL-C>  will  return  you  to  HERMES. 
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4 INTRODUCTION  TO  HERMES 


f: 


8.2  EDITING  CHARACTERS 


<RUBOUT>  deletes  a stnQle  character. 

<C1RL-W>  deletes  a single  word. 

<C1RL-U>  deletes  a line  of  text. 

<CTRL-R>  retypes  a line  of  text. 

<CIRL-Z>  ends  the  Text:-f1e1d;  prints  tz. 


8.S  TYPING  COMMANDS 


Yon  can  u&r  either  the  space  character  or  the  Escape-key  (or  ALT  MODE)  to  separate  the 
different  sections  within  a command.  The  Escape-key  <ESC>  causes  HERMES  to  print  out 
rouipletely  any  word  used  in  command  and  then  to  print  "noise  words"  to  introduce  the 

next  word,  if  it  is  possible  to  type  one.  At  such  a point,  typing  <ESC>  causes  HERMES  to 

insert  the  "default"  word.  Most  commands  have  a set  of  defaults,  chosen  to  be  most  useful 
to  the  beginning  user.  For  example,  PRINT  prints  the  current  message  in  the  form 
specified  by  the  PTEMPLATE  onto  your  terminal  (symbol  TTY:).  If  the  current  message 
is  No.  10,  and  you  type  "PR",  followed  by  a scries  of  <ESC>’s  you  will  see: 

>PRINT  (messages)  10  (using  template)  PTEMPLATE  (on  file)  TTY: 

You  may  type  "?"  at  almost  any  point  in  the  HERMES  system  to  see  what  words  you  are 
allowed  to  type  In  next. 

>7  gives  a list  of  top-level  HERMES  commands. 

>SU7  lists  comr.inds  that  begin  with  *SU*. 

>SURVEY  7 lists  all  the  things  that  you  nay  type  In  at 

that  position  In  the  "SURVEY*  command. 

Use  7 and  <ESC>  freely. 

7 tells  what  choices  you  have. 

<rsc>  tells  what  defaults  the  system  has  set  up. 

To  find  out  what  can  be  typed  at  a given  point,  type  ”7".  The  system  prints  all  possible 
choices  on  your  terminal.  Use  the  T and  <ESC>  features  freely;  they  reduce  what  you  have 
to  remembff  and  help  you  understand  the  range  of  the  system. 
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8.4  ENTERING  HERMES 
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When  you  sef  the  Exec  prompt  "m",  type  HERMES.  foUowrd  by  a carriage  return.  The 
HERMES  Message  System  responds  with  the  HERMES  prompt  V,  and  prints  brief  surveys 
of  any  messages  that  have  arrived  since  your  last  session.  The  message-file  you  see  when 
you  enter  the  HERMES  system  Is  your  INBOX,  which  has  the  file-name  MAIL.TXT.1. 

When  you  enter,  you  can  tell  HERMES  to  Input  a different  message-file  by  typing 

fHrRHES.<CR> 

(using  iaessage*f11e)  <f11e-nane><CR> 

To  direct  the  attention  of  the  HERMES  system  to  another  message-file,  after  you  enter 
HERMES,  type 

>GtT  <ri1e-name><CR> 

When  you  first  enter  HERMES,  your  FILENAME-INPUT  switch  is  set  to  TENEX  or  TOPS- 
20,  and  your  file-names  are  handled  as  in  the  operating  system.  For  simplified  file- 
handling  within  HERMES,  you  can  set  your  FILENAME-INPUT  switch  to  HERMES. 

>Edlt  switches«:r> 

»Set  FllENAHE-lNPUT  HERHES<CR> 

>>Dono<CR> 


All  files  now  have  single-word  names,  which  are  extended  and  recognized  like  other  words  in 
HERMES  commands.  For  example,  your  INBOX  is  named  MAIL.TXT.  If  you  have  a file 
named  NEWFILE,  and  no  other  files  beginning  with  NEW,  you  can  now  type: 

>Got  NEW<CR>  (C0NFIRn)<CR> 

To  see  a list  of  your  message-files,  type 

>Show  NESSAGE>FILES<CR> 

For  more  Information,  type 

>0ESCRIBE  FILEfMHE-INPUT-SVITCH<CR>. 
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Whrn  you  want  to  Irave  HERMES,  type  QUIT  (or  aimply  Q)  to  the  HERMES  prompt  ">' 
foHowed  by  a carriage  return.  QUIT<CR>  returns  you  to  the  Exec. 


>0UIT<CR> 


If  you  have  deleted  any  messages.  HERMES  asks  whether  you  want  to  expunge  them  (l.e. 
take  them  away  forever).  If  you  see  the  prompt  "»*  or  *>»”.  you  must  first  type  "DONE*. 


»DONE<CR> 

>QUIT<CR> 


After  you  QUIT,  you  may  continue  by  typing  CONTINUE  to  the  • prompt: 


fC0N1INIIE<CR> 


If  you  wish  to  logout  directly  from  HERMES,  type  LOGOUT,  followed  by  a carriage 
return.  This  is  equivalent  to  typing  QU1T<CR>  to  the  HERMES  prompt  and  then 
typing  LOCOUT<CR>  to  the  TOPS-20  prompt 


>LOGOUT<CR> 


Examples: 


PIIFRHES<CR> 

NLRHES  4.0.17  ?6*AU6-77 

-*B  252  29  SEP  77  Wolf  at  BBN-TENEXD  HIT  Press  annual  book  sale 
(tirRNFS  session] 

>0UIT<CR> 


>LOCOUT<CR> 

(TOPS-?0  logout  nessaoe] 


8.6  READING  MESSAGES 


For  a quick  survey  of  all  messages  In  your  message-file,  type 


>SURVEV<CR> 


>S<CR> 


To  SURVEY  specific  messages,  c.g..  S,  1,  and  4 through  6,  type 


>SURVEY  3,1.4:6<CR>  or  >S  3.1,4:6<CR> 


To  print  messages  in  full,  one  at  a time,  type  the  LlNE-FEED-key.  The  HERMES  System 
steps  through  the  messages,  always  printing  the  next  message  in  the  message-file.  To  back 
up  and  print  the  previous  message,  type  the  up-arrow  character  "t”.  To  print  the  current 
message,  use  the  PRINT  command.  You  need  type  only 


>PRINT<CR>  or  >P<CR> 


To  PRINT  other  messages,  specify  as  in  SURVEY: 


>PRINT  3.1.4:6<CR>  or  >P  3.1.4:6<CR> 


The  PRINT  command  resets  the  CURRENT  message  to  the  last  message  printed.  If  you 
now  type  LINE-FEED,  HERMES  prints  message  7.  HERMES  tells  you  when  you  have 
messages  that  have  arrived  recently.  HERMES  prints  a "survey”  of  each  message,  when  you 
log  In  or  when  a new  message  arrives: 


♦ 1 S36  lS-Jul-77  ROGERS  at  BBN-TENEXA  HERMES  HELP  INFORNATIO 


For  a quick  survey  of  all  messages  in  your  current  message-file. 


>SURVEY<CR> 


To  print  the  text  of  a single  message: 


The  LINEFEED  key  (NOT  followed  by  <CR>) 
prints  the  NEXT  nessape,  AND 
sets  It  to  be  the  CURRENT  message. 


><tF> 


When  a new  message  arrives,  it  is  generally  the  NEXT  message,  unless  you  have  been 
akipping  around  in  your  file. 


The  UP-ARROW  or  CARET  key  (NOT  followed 
by  <CR>)  prints  the  PREVIOUS  message 
AND  sets  the  CURRENT  message, 
prints  the  CURRENT  message. 


>PRINT<CR> 


To  print  a survey  of  all  messages  from  |ONES.  type 


>SURVEY  FROM  J0NES<CR> 


To  SURVEY  all  messages  that  are  from  Jones  and  to  Smith,  type 


>SURVEY  FROH  JONES/TO  SMITH<CR> 


To  PRINT  all  mesMges  that  arc  from  Jones  and  have  the  words  "message  serricc"  In  their 
sttbjrct  fields,  type 

>PRINT  FROH  JONES/SUeJCCT  "NESSAGE  SERVICE”<CR> 

If  you  search  for  only  one  word,  you  can  omit  the  quotes. 


9.7  SENDING  MESSAGES 


To  send  a message,  type  "COMPOSE*  to  the  Hermes  prompt  *>"< 

>CONPOSE<CR> 

The  COMPOSE  command  gives  you  a series  of  prompts  that  guide  you  through  composing 
a message.  The  To:  and  Cc:  fields  must  be  filled  in  with  names  of  "directories"  on 
ARPANET  computers.  The  To.  Cc  and  Subject  fields  end  with  <CR>  but  the  Text  field 
ends  with  <CTRL>Z>.  When  you  are  done  composing,  HERMES  allows  you  to  format  and 
send  the  message.  You  should  check  your  PTEMPLATE  using  the  SHOW  command  to  find 
out  what  switches  are  set.  If  the  format  switch  Is  set  to  NO  you  may  change  it  to  either 
ASK  or  YES  using  the  SET  command.  After  you  type  <CTRL-Z>,  the  system  asks 

SEND?:  You  nay  answer  yES<CR>  or  IIO<CR>. 

If  you  answer  YES<CR>.  HERMES  SENDS  your  message.  If  HERMES  Is  able  to  deliver  it 
immediately,  it  tells  you  that  the  copy  of  the  message  to  an  addressee  is  "delivered".  If  not, 
HERMES  queues  the  message  for  another  program.named  MAILER,  which  picks  the 
message  up  a few  minutes  later  and  delivers  it.  HERMES  docs  not  tell  you  which  messages 
are  queued.  If  you  type  NO<CR>.  HERMES  does  not  SEND  the  message.  Instead,  you  can 
do  more  work  on  the  message.  For  example,  you  can  add  another  name  to  the  CC:  fiekk 

>KC:  YOURNAHE<CR>  Notice  the  double  pronpt  *»*. 

When  you  want  to  send  the  message,  type  SEND<CR>  and  "confirm*  with  a second  <CR>. 

»SEND<CR>  (CONFIRH)  <CR> 

> 

Using  the  SEND  counand  takes  you  back 
to  the  *>*  pronpt. 
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If  you  change  your  mind  about  sending,  after  the  computer  prints  (CONFIRM),  you  can 
stop  It  with  <CTRL-ll>.  Some  commands,  such  as  SEND  and  ERASE,  cause  irremsible 
actions  to  take  place.  When  you  terminate  such  a command  with  the  usual  <CR>,  Hermes 
asks  you  to  confirm  by  printing  tConfirm]"  on  your  terminal  You  may  then  either 


a)  confirm  with  another  <CR>,  or 

b)  abort  the  command: 


2)  Type  <CTRL>U>.  The  <CTRL-Q>  key  has  the  same  effect  as  <CTRL>U> 
unless  you  have  a scope  terminal  which  you  set  to  "terminal  page"  mode. 


Type  either  Yes<CR>  or  No<CR>  in  response  to  a question.  Yes  and  No  may  be  abbreviated. 
Examples: 


»SEND  <CR> 

[Conrirn]<CR>  The  message  Is  sent. 

»SEND<CR> 

( Confirm ]<CTRL-Q>  The  SEND  command  Is  aborted. 
>FIIE  1:3,5  SAVED<CR> 

Oolete  messages  after  ftltng?  Y<CR> 

1:3,5 

Messages  are  deleted  from  your 
message-file. 

>FILE  1:3,4  SAVEO<CR> 

Delete  messages  after  filing?  N<CR> 

1:3,5 

Messages  are  not  deleted. 


To  reply  to  a message  in  your  message-file: 


gives  you  prompts  for  your  reply  to  the 
CURRENT  message, 
replies  to  Message  5. 


>RrPLV<CR> 


>REPLY  5<CR> 


The  REPLY  command  automatically  sets  up  fields  in  the  outgoing  message  (typing  them 
out  as  It  docs  so)  so  all  that  is  required  of  the  user  is  to  enter  the  Text:-field.  The  user  Is 
given  the  option  of  replying  just  to  the  author  of  the  original  message  or  sending  copies  to 
Its  other  recipients  as  well  To  forward  a message  in  your  message-file  to  someone  elm: 


forwards  the  CURRENT  Mssaga,  i 
prompts  you  for  addrassoes  and 
commants. 

forwards  Nassaga  5 


>FORtfARO  »<CR> 


The  FORWARD  command  prompts  for  the  Toe  and  Subject:  fields,  sets  up  the  Subject: 


fIrM  to  rrference  the  forwirdcd  messages  following  the  user’s  subject  and  then  gives  the 
user  • chance  to  enter  comments.  Following  any  comments.  FORWARD  will  ‘’package"  the 
messages  to  be  forwarded  In  the  message  Just  built,  then  request  permission  to  send  it. 


8.8  NAMED  SEQUENCES 


To  organize  your  messages,  HERMES  provides  facilities  for  grouping  messages  into  named- 
sequences.  A named-sequence  Is  an  ordered  set  of  messages.  Individual  messages  can 
appear  In  as  many  different  named-sequences  as  you  wish.  For  example,  to  create  a 
sequence  named  ANSWERED,  you  type: 


>CRFATf  SFQUENCE  ANSWEI(EO<CR> 


This  enters  the  sequence-editor  and  HERMES  prompts  you  with  a double  arrow, 
messages  M.8  and  7 to  this  sequence,  type: 


»ADO  3:S,7<CR> 
»DONE<CR> 


Once  a sequence  is  created,  you  can  add  messages  without  entering  the  sequence-editor.  You 
use  the  ADD  command  and  specify  both  the  messages  and  the  named-sequence: 


>ADD  9 ANSWEREO<CR> 


To  find  out  which  sequences  a message  is  In.  use  the  WHEREIS  command: 


>WtlEREIS  9<CR> 

9 Is  tn  ANSWERED 


To  see  a list  of  all  messages  In  a sequence,  for  example.  In  ANSWERED,  type: 


>SIIOW  ANSWEREO<CR> 
3:5. 7.9 


Sequences  can  be  used  In  all  of  the  message-handling  command  mentioned  above.  To 
survey  all  messages  In  ANSWERED,  type: 


>SUIIWCY  AIISVERED<CR> 


8.9  MFSSACE  MANAGEMENT 


Wltkln  a mrssage'filf.  messages  can  be  organised  into  NAMED-SEQUENCES,  which  can  be 
thought  of  as  overlapping  'file  folders".  The  command  for  filing  messages  Is  FILE.  You 
must  specify  the  messages  and  the  file  you  want  them  filed  in.  If  the  file  you  name  does 
not  exist.  HERMES  creates  It.  The  file-name  may  contain  upper-case  letters,  numbers  or 
the  hyphen  and  may  not  be  more  than  SO  characters  long. 

HUE  3. 1,4:6  SAVED-NS6S<CR> 

If  the  file  Is  from  a different  directory  than  your  current  one.  the  file-name  consists  of  the 
directory  name  enclosed  in  angle  brachets.  l.e..  "<SMITH>",  followed  by  the  file-name  itself. 

HUE  3. 1.4:6  <SHITH>SAVE0-HS6S<CR> 

The  FILE  command  copies  messages  from  your  current  message-file,  then  asks  whether  you 
want  to  delele  the  original  messages.  To  shift  HERMES'  attention  to  another  file  of 
messages,  for  example.  SAVED-MSC.  type: 

>CFT  SAVEO-NSG<CR> 

AH  subsequent  commands  will  now  work  with  this  new  file.  Examples: 

HUE  3. 1,4:6  SAVEO-NSGS<CR>  [New  fl1e]<CR> 

Delete  Messages  after  filing?  Yes<CR> 

3, 1,4:6  filed  and  deleted. 

You  may  answer  "Y*  Instead  of  "Yes”.  If  you  do  not  want  to  delete  the  message,  answer 
•>lo"  or  "N". 

HUE  7,9,11  SAVE0-HS6S<CR>  (Old  versionKCR> 

Delete  awssages  after  filing?  N<CR> 

7,9,11  filed. 


8.10  MESSAGE  DELETING 


The  command  for  getting  rid  of  messages  is  DELETE.  To  delete  the  current  message,  type 
>DELETE<CR>  or  >D<CR> 

To  delete  other  messages,  type 
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>OriETE  7.9J1:1S<CR>  or  >0  7.9,n:lS<CR> 


THU  morhs  the  mnsages  at  DELETED.  Yoa  cannot  SURVEY  or  PRINT  them  but  you  can 
UNDELETE  tbem: 


>UN0ELEfE  7.9.11:1S<CR> 


At  the  end  of  each  HERMES  session,  when  you  QUIT  or  LOGOUT.  HERMES  asks  you 
whether  you  want  to  have  your  deleted  uiess^es  EXPUNGED.  When  message  are 
expunged,  they  are  physically  removed  for  the  file  and  the  remaining  messages  are 
renumbered.  Examples: 


>SURVEY<CR> 

>DELETE  3.&<CR> 

>QUII<CR> 

Mossages  1.3:S  delated. 
Expunge  and  reniMberT  Yes<CR> 


9HERI1ES<CR> 

>SURVEY<CR> 


8.11  ON-LINE  DOCUMENTATION 


The  on-line  documentation  material  Is  basically  a reference  manual  arranged  as  short  topics 
with  associated  examples.  The  topics  are  organised  In  a table  of  contents  or  OUTLINE. 


>OUTLINE<CR> 


shows  the  first  two  layers  of  topic  naaws 
and  Is  equivalent  to  the  couMnd 


MXITLINE  HCRNES  (to  depth)  2<CR> 


You  may  use  the  OUTLINE  command  with  any  topic,  and  with  the  depth  argument  set  to 
E.  9. 4 ...  All.  To  see  the  contents  of  a topic,  type 


>0ESCRIBC  <top1c><CR> 


The  topic  defauhs  to  "HERMES”  at  top  command  levcL  to  "MESSAGE-EDITOR*  when  you 
arc  creating  a message,  and  to  other  appropriate  topics  In  other  parts  of  the  system.  For 
more  Information,  type 


Plca»«  note  tliat  when  bugs  are  discovered  in  the  production  version  of  Hermes,  which  is 
installed  as  <S11BSYS>HERMES,  we  will  try  to  put  up  a fixed  version  as 
<NF.WSYS>HERMES.  as  soon  as  possible.  Watch  the  HERMES  herald  line,  or  type 
NEWS<CR>  for  details. 


8.12  HERMES  BASIC  COMMAND  SUMMARY 


This  summary  gives  the  basic  commands  for  reading  and  composing  messages.  HERMES 
has  many  more  commands  and  features  than  appear  here. 


Type  a Carriage-Return.  <CR>,  after  all  commands  except  Line-Feed,  <LF>,  t and  “control 
characters".  Sometimes  you  may  type  additional  words  before  the  <CR>,  to  modify  the 
action  of  the  command.  Only  the  most  frequently  used  of  these  words  are  shown  on  this 
list. 


ENTERING  and  LEAVING  HERMES 


Prompt:  8,  >.  or  » 


Gives  you  access  to  the  HERHES  program. 

Leaves  HEMtES;  returns  you  to  operating  system 


8IIERHES 

>Qun 


SPECIAL  TERMINAL  KEYS 


Tho  key  marked  ESC  la  the  Escepe*Key,  <ESC>.  The  key  marked  CTRL  Is 
the  Control-Key,  <C1RL>.  To  type  a Control -Character,  hold  down  the 
<CTRL>  and  almuUanaously  type  the  letter  key. 


<ESC>  and  T 


Causes  NCRNES  to  complete  a word,  to  print  "guide  words", 
or  to  Insert  a default  word.  Type  <ESC>  repeatedly  to 
learn  about  a command. 

Causes  HERHES  to  show  tho  words  you  aro  allowed  to  typo  at 
at  any  point,  oven  within  a word. 


<ESC> 


PANIC  BUTTONS 


L 

0 

li 

If 

0 

0 

! 

I 

1 

L 

0 

G 

I 

1 

i: 

li 

i] 

c 

D 


Cun  be  used  anywhere. 

<C1RL-C>  Aborts  a command  at  any  time. 

<C1Rl>0>  Stops  printout  on  your  terminal. 

<C1RL-C>  Stops  HERMES.  Returns  to  the  operating  system. 

Recover  by  typing  CONTINUE  to  the  t prompt.  If  you 
are  In  Teco,  Xed  or  Noted,  returns  to  HERHES. 
<CTRL-T>  Shows  system  Is  working,  tells  system  load. 

EDITING  CHARACTERS 

For  typing  commands  and  editing  fields. 

<KUBOUT/DCL>  Deletes  a single  character. 

<C1RL>II>  Deletes  a line  In  text;  aborts  a command. 

<C1RL-V>  Deletes  a word  In  text,  or  a part  of  a command. 

<C1RL-R>  Retypes  a line  of  text. 

<C1RL-Z>  Ends  the  Text:-f1eld,  or  any  TEXT-type  field. 

<C1RL-1>  Inside  a field.  Inserts  a tab.  Tab  stops  are  set 

every  B spaces.  One  tab  alone  on  a line  turns  OFF 
FORMAT.  Two  tabs  alone  turn  ON  FORMAT. 

<CTRL-B>  Inside  a field.  Inserts  the  contents  of  a file. 
Prompts  for  file-name. 

! Escape  from  Hermes  file-names.  Type  I before  name. 

USEFUL  SYMBOLS 

CMFSSAGE  (the  current  message) 

* ALIHESSA6ES  (all  the  messages  In  a message-file) 

X LASTMESSAGE  (the  last  In  a file)  or  the  last  Tina  In  a field. 
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INFORMATION  COMMANDS 

Profiipi:  > 

>MLIP 
>Nrws 
>SIA1US 

>DFSCRIBE  topic 

>[ XAHPLE 

>0U1L1NE  topic 

READING  MESSAGES 
Prompt:  > 

XI F>  or  LlnoFoed  Prints  NEXT  message.  Do  not  type  <CR>. 

><t>  Prints  PREVIOUS  message.  Do  not  type  <CR>. 

>SURVEY  messages  Prints  a summary  of  messages. 

>PRINT  messages  Prints  In  full.  Resets  current  message. 

MANAGING  MESSAGES 

Prompt:  > 

>OIIETE  messages  Narks  messages  deleted. 

>UNOELETE  messages  Restores  deleted  aiessages. 

>rilE  messages  file  Copies  message  Into  another  message-file. 

>GET  file  Changes  the  currant  messaga-flla. 

COMPOSING  MESSAGES 

Prompt:  > 

>COHPOSE  Prompts  you  to  compose  a new  massage. 

>REPLr  message  Prompts  a reply.  (Default:  currant  message.) 
>fORVARO  messages  Places  messages  In  Text:  field  of  a new  draft; 

prompts  you.  (Default:  current  message.) 


Prints  the  HERNES  HININAL  REFERENCE  SUNNARY 
News  of  latest  changes. 

Shows  your  directory  and  current  message-file. 
Information  about  a large  number  of  topics. 
Prints  example  of  topic  Just  DESCRIBEd. 

Shows  a structured  outline  of  topics. 
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COMPOSING  A DRAFT  MESSAGE:  The  Draft  Editor 


I 


ProNipt:  » 

A Draft  Is  an  unsent  Message,  which  consists  of  a collection  fields. 
You  can  create  a draft  with  the  top-level  coMmands  COHPOSE.  REPLY  or 
FORWARD.  HERHES  prompts  you  for  the  fields.  If  you  do  not  SEND  the 
draft,  you  are  placed  in  the  DRAFT-EDITOR,  with  » prompt. 

SECOND-LEVEL  COMMANDS  FOR  LEAVING  THE  DRAFT-EDITOR 


Prompt:  » 

Erases  draft  and  returns  you  to  top  level. 

Does  not  erase  draft.  Returns  you  to  top  level. 
Distributes  draft  as  a message  to  addressees  in  To:, 
Cc:  and  Bcc:  fields,  and  to  files  in  Fee:  field. 

FIELDS  THAT  CAN  BE  USED  AS  SECOND-LEVEL  COMMANDS 

Prompt:  » 


ABORT 

DONE 

SEND 


HTRNES  recognises  a number  of  standard  fields,  in  five  types. 


Oata-Type 

ADDRESSEE 


DATE 

LINE 

TEXT 

FILE 


Contents  of  Field 

Network  addresses,  of  the  form  NAME  or  NANEPNOST. 

Only  the  To:,  Cc:  and  Bcc:  fields  cause  SEND  to 
distribute  messages  to  addressees. 

Accepts  a single  date,  in  any  reasonable  format  that 
includes  day,  month  and  year. 

Plain  text,  ending  with  a <CR>,  like  the  Subject:. 

Plain  text,  ending  with  a <CTRL-Z>,  like  the  Text:. 

Fee:  only.  SEND  distributes  messages  to  files  in  Fee:. 


Field  Name 
Bcc: 

Cc: 

Fee: 

From: 

Keywords: 

Subject: 

To; 

Text: 


Oata-Type 

ADDRESSEE  Blind  Carbon  Copy.  Bcc  names  are  seen 
only  by  others  on  the  Bcc  list. 
ADDRESSEE  Carbon  Copy. 

FllE  File  Carbon  Copy. 

LINE  SEND  fills  in  From:  if  you  do  not. 

LINE 

LINE 

ADDRESSEE 

TEXT  Allows  <CR>s;  ends  with  <CTRL-Z>. 
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Some  fields  are  seldom  used  as  commands  but  are  filled  In  by  HERHES: 


Date:  Date  message  was  sent. 

In-Reply-To:  Filled  In  by  the  REPLY  command. 

Mcssage-ID:  Unique  ID  composed  of  Host,  Date  and  Sender. 

Redlstrlbuted'By:  Filled  In  by  the  REDISTRIBUTE  command. 
Redlstrlbuted-Date:  ■ ■ • ■ • • 

Redlstrlbuted-By:  ■ • • • « 

Sender:  Login  directory  of  user  who  SENDs  the  message. 

Some  standard  fields  are  seldom  used:  Start-Datii,  End-Date, 
Suspense-Date,  Class-Char,  Hessage-Class: , Special-Handling. 

SIMPLE  SECOND-LEVEL  COMMANDS  FOR  EDITING  THE  DRAFT 

Prompt:  >> 

You  may  omit  the  "line*  and  type  only  the  field  name.  Two  switches 
control  the  CHANGF-BELL  (bell  or  !)  and  the  SHOW-FIELD-DEFAULT  (lines 
In  single  fields  shown  numbered  or  unnumbered). 


ERASE 


FORMAT 


INSERT 


SPILL 


lines  field  Erases  specified  lines.  (Default:  entire  draft. 

You  may  type  a field  name  or  HEADER,  too.) 
linos  field  Adjusts  lines  In  a field  to  65-character  maximum. 
(Default:  Text:) 

line  field  Lets  you  Insert  text  before  a specified  line  In 
a field.  Ends  with  carriage-return  or  <CTRL-Z>. 
lines  field  numbered/unnumbered 

Displays  specified  lines  of  a field  on  your 
terminal.  (Default:  entire  draft.  You  may  type 
a field  name  or  HEADER,  too.) 

Runs  program  to  correct  spelling.  (Text:  only.) 


THE  CHANCE  COMMAND 

CHANGE  has  a set  of  single-character  subcommands.  These  are  not 
printed  on  your  terminal  as  you  type  them,  but  they  cause  some 
conventional  signs  /,  and  f (or  a bell)  to  be  printed,  similar  to 
the  signs  printed  by  the  <CTRL-A>  and  <CTRL-W>  characters. 
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* 1 


0 


CHANGE  line  field  numbered/unnumbered 

Lets  you  change  a line  by  copying  froai  an  "old” 
version  Into  a "new*  version. 


y 


Subcommands  of  CHANGE  (used  within  line,  not  echoed  on  terminal): 


r. 

c 

c 

1. 

i 

i 


< space > 
n< space) 
<CR> 

E 


Copies  one  character  from  old  line  to  new. 
Copies  n characters. 

Copies  the  rest  of  line  and  ends  CHANGE. 
Copies  to  End  of  line. 


Sc 


S< space) 
nSc 


Searches  for  any  character  c.  Attempts  to  awteh 
case  (upper  or  lower)  of  c,  then  searches  for 
other  case.  Copies  up  to  c. 

Searches  for  a space;  thus  copies  to  the  end  of 
the  next  word. 

Searches  for  nth  c,  then  copies  up  to  nth  c. 


B 


Breaks  line  Into  two  lines.  (To  combine  two 
lines,  leave  CHANGE  and  use  FORHAT.) 


y 

i; 

I 


\ 


c 

I) 


I 


Begins  an  Insertion.  End  with  <CR)  or  <CTRL-Z). 
(Rings  bell  or  prints  is.) 


D 

nD 

<RUBOUT/DEL) 

n<RUBOUT/DEL) 

<C1RL-U) 

CCIRL-N) 

n<CTRL-tf) 


Deletes  next  character  to  right.  (Prints  /s.) 
Deletes  n characters  to  right. 

Deletes  character  to  left.  (Prints  s.) 

Deletes  n characters  to  left. 

Deletes  line  to  left. 

Deletes  one  word  to  left.  (Prints  <s.) 

Deletes  n trords  to  left. 


<CTRL<-R)  Retypes  line. 

<CTRL>0)  Retypes  entire  field. 
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9.  MAII^TAT  PROGRAM 


MAII.STAT  lists  all  queued  and  undeliverable  mail  in  the  connected  directory.  It  also 
accepts  commands  to  manipulate  the  undeliverable  messages  - they  can  be  deleted  or  put 
bach  on  the  queue  to  be  mailed  (with  a different  address  If  desired). 


Example 


9ma11stat 
MAILSTAT  IBdl) 
lypo  ? for  help 

•7 


HAILS1AT  lists  existing  queued  and  undellverable  mall  In 
connected  directory.  It  also  permits  manipulation  of 
undellverable  mal'1. 


Commands  ore 


Q - list  queued  mall 

U - list  or  manipulate  undellverable  mall 
H - halt  - exits  program 
7 - types  this  message 

carriage  return  - lists  both  queued  and  undellverable  mall 


"Queued  mall 


Commands  art: 

L • list  undeliverable  mall 
carriage  return  - same  as  L 
H * halt  • exit  to  higher  level  (back  to  *) 

T > types  this  laossage 
H - manipulate  undellverable  mall  • 

Same  as  L,  but  after  each  Item  Is  listed,  waits  for  you  to  choose 
one  of  the  following  options.  Except  as  noted  below,  the  option 
must  be  confirmed  with  a carriage  return,  or  may  be  aborted  with 
rubout  (del). 

S - save  - does  nothing  * status  of  mall  Is  unchanged 
carriage  return  - same  as  S.  but  no  confirmation  required 


delete  message 
requeue  message 

address  change  • allows  you  to  specify  a different  address  for  the 
mall  and  requeues  the  mall  for  the  modified  addressee. 


9.1  USING  MAILSTAT  IN  HERMES 


Maiistat  lists  queued  and  undellverable  messages  In  a logged>ln  or  connected  directory  and 
allows  you  to  manipulate  undellverable  messages. 


If  undellverable  mail  exists.  MAILSTAT  automatically  enters  you  into  a set  of 
subcommands,  similar  to  an  editor.  The  subcommands  are  SHOW,  PRINT,  REQUEUE, 
READDRESSftREQUEUE,  DELETE,  and  NO-ACTION-FOR. 

Also  available  are  the  general  subcommands  ABORT.  DONE,  DESCRIBE.  OUTLINE. 
EXAMPLE,  and  DOCUMENT. 


Example 


>ma11stat 

<tiOl6> 

Undellverable  smII: 

to  date  queued  action 

1 AnybodytlSIB  1-Jun>78 

2 ColotlSIC  l-Jun-78 


>>rcaddressAre<|ueuc  (undellverable  Message  nuMber)  2 

lo:  ColebISIB 

>>show 

Undcitverable  awtl: 

to  date  queued  action 

1 AnybodydlSlS  l>Jun-78 

2 ColeBISIC  l-Jun-78  READORESS/REQUEUE  to  ColeBISIB 

»de1ete  1 

»sboiif 

Undellverable  Mall: 

to  date  queued  action 

1 AnybodyBlSlB  l-Jun-78  DELETE 

2 ColeBISIC  1-Jun-7B  READDRESS/REQUEUE  to  ColeBISIB 


»No'ect1on>ror  (undellverable  Message  nuMbers)  1 
Hcssage  1 Marked  for  deletion.  Cancel 

deletion  and  leave  as  undellverable  Instead?:  yes 
»requoue  (undellverable  Message  nuMbers)  1 
>>show 

Undellverable  Mall: 

to  date  queued  action 

1 AnybodyBlSlB  l>Jun-78  REQUEUE 

2 ColeBISIC  l-Jun-78  READORESS/REQUEUE  to  ColeBISIB 


>>done 

>na11er 


No  acknowledgeMents  for  H0L6 
Queued  mall  from  HOLG 

AnybodyBlSlB  , FTP  ok  No  such  mailbox  at  this  site 
. RFNAHEO. 

ColeBISIB,  FTP  ok,  mall  allowed,  sent  ok,  deleted. 

>ma11stat 

<II01G> 

Undellverable  mall: 

to  data  queued  action 

1 AnybodyBlSlB  l-Jun-78 


»done 


